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.h (包括 Mcd.h、 Ntddchgr.h) |
連結庫 | Mcd.lib |