ChangerClassInitialize 函式 （mcd.h）

ChangerClassInitialize 例程會初始化驅動程式。

語法

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

參數

[in] DriverObject

changer miniclass 驅動程式物件的指標。 這會當做參數傳遞至迷你類別驅動程式的 DriverEntry 例程。 此物件的格式是作系統特定的，不應由迷你類別驅動程式解譯。

[in] RegistryPath

變更程式迷你類別驅動程式之登錄路徑的指標。 這也會當做參數傳遞至迷你類別驅動程式的 DriverEntry 例程。 此格式為作系統專屬，不應由迷你類別驅動程式解譯。

ChangerInitData

包含迷你類別驅動程式特定資訊的 MCD_INIT_DATA 結構的指標，例如變更程式迷你類別驅動程式命令處理例程的進入點。

傳回值

ChangerClassInitialize 傳回值，指出驅動程式初始化的成功或失敗。 如果初始化成功，ChangerClassInitialize 會傳回STATUS_SUCCESS。 否則，ChangerClassInitialize 會傳回適當的錯誤訊息。 Minidrivers 應該 不 解譯這個錯誤值，而應該只從其 DriverEntry 例程傳回此值。

言論

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

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

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

要求

另請參閱

MCD_INIT_DATA

RtlZeroMemory