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 會傳回適當的錯誤訊息。 Minidrivers 不應該 解譯這個錯誤值，但應該只從其 DriverEntry 例程傳回此值。

備註

ChangerClassInitialize 是變更類別驅動程式例程，迷你類別驅動程式可以在 Microsoft Windows XP 和更新版本的操作系統中呼叫。

Changer 迷你類別驅動程式會從其 DriverEntry 例程內呼叫 ChangerClassInitialize，以初始化驅動程式。 ChangerClassInitialize 會執行許多先前由changer類別驅動程式 DriverEntry 例程執行的工作，例如註冊迷你類別驅動程式的分派例程。 它會配置驅動程式物件延伸模組，並將 MCDInitData 中包含的數據複製到驅動程式物件延伸模組，以及其他初始化數據，例如驅動程式的登錄路徑和操作系統特定特定變更器類別驅動程式例程的指標。

Changer miniclass 驅動程式必須配置MCD_INIT_DATA結構、藉由呼叫 RtlZeroMemory，然後將值指派給適當的成員，再透過 MCDInitData 參數將結構的地址傳遞至 ChangerClassInitialize。

規格需求

另請參閱

MCD_INIT_DATA

RtlZeroMemory