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 미니클래스 드라이버는 DriverEntry 루틴 내에서 ChangerClassInitialize를 호출하여 드라이버를 초기화합니다. ChangerClassInitialize 는 이전에 미니클래스 드라이버의 디스패치 루틴 등록과 같은 변경자 클래스 드라이버의 DriverEntry 루틴에서 수행한 많은 작업을 수행합니다. 드라이버 개체 확장을 할당하고 MCDInitData 에 포함된 데이터를 드라이버 개체 확장에 복사하고 드라이버의 레지스트리 경로 및 운영 체제별 특정 변경자 클래스 드라이버 루틴에 대한 포인터와 같은 다른 초기화 데이터와 함께 복사합니다.
Changer miniclass 드라이버는 MCD_INIT_DATA 구조체의 주소를 MCDInitData 매개 변수를 통해 ChangerClassInitialize에 전달하기 전에 rtlZeroMemory를 호출하여 구조체를 할당하고 구조체를 0으로 할당한 다음 적절한 멤버에 값을 할당해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | mcd.h(Mcd.h, Ntddchgr.h 포함) |
| 라이브러리 | Mcd.lib |