ChangerClassInitialize 함수(mcd.h)

ChangerClassInitialize 루틴은 드라이버를 초기화합니다.

통사론

NTSTATUS ChangerClassInitialize(
  [in] PDRIVER_OBJECT  DriverObject,
  [in] PUNICODE_STRING RegistryPath,
       PMCD_INIT_DATA  ChangerInitData
);

매개 변수

[in] DriverObject

체인저 미니 클래스 드라이버 개체에 대한 포인터입니다. 이는 미니클래스 드라이버의 DriverEntry 루틴에 매개 변수로 전달됩니다. 이 개체의 형식은 운영 체제별로 지정되며 미니클래스 드라이버에서 해석해서는 안 됩니다.

[in] RegistryPath

체인저 미니 클래스 드라이버의 레지스트리 경로에 대한 포인터입니다. 또한 미니 클래스 드라이버의 DriverEntry 루틴에 매개 변수로 전달됩니다. 이 형식은 운영 체제별로 지정되며 미니클래스 드라이버에서 해석해서는 안 됩니다.

ChangerInitData

체인저 미니클래스 드라이버의 명령 처리 루틴에 대한 진입점과 같은 미니클래스 드라이버 관련 정보를 포함하는 MCD_INIT_DATA 구조체에 대한 포인터입니다.

반환 값

ChangerClassInitialize 드라이버 초기화의 성공 또는 실패를 나타내는 값을 반환합니다. 초기화에 성공하면 ChangerClassInitialize STATUS_SUCCESS 반환합니다. 그렇지 않으면 ChangerClassInitialize 적절한 오류 메시지를 반환합니다. 미니 드라이버는 이 오류 값을 해석하지 DriverEntry 루틴에서 이 값을 반환해야 합니다.

발언

ChangerClassInitialize 미니클래스 드라이버가 Microsoft Windows XP 이상 운영 체제에서 호출할 수 있는 체인저 클래스 드라이버 루틴입니다.

Changer miniclass 드라이버는 DriverEntry 루틴 내에서 ChangerClassInitialize 호출하여 드라이버를 초기화합니다. ChangerClassInitialize 이전에 체인저 클래스 드라이버의 DriverEntry 루틴(예: 미니클래스 드라이버의 디스패치 루틴 등록)에서 수행한 많은 작업을 수행합니다. 드라이버 개체 확장을 할당하고 MCDInitData 포함된 데이터를 드라이버 개체 확장에 복사하고 드라이버의 레지스트리 경로 및 운영 체제별 특정 변경자 클래스 드라이버 루틴에 대한 포인터와 같은 다른 초기화 데이터와 함께 드라이버 개체 확장에 복사합니다.

Changer miniclass 드라이버는 MCD_INIT_DATA 구조를 할당하고 RtlZeroMemory호출하여 구조를 0으로 지정한 다음 해당 멤버에 값을 할당한 후 MCDInitData 매개 변수를 통해 구조체의 주소를 ChangerClassInitialize 전달해야 합니다.

요구 사항

참고 항목

MCD_INIT_DATA

rtlZeroMemory