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 ミニクラス ドライバーは、MCD_INIT_DATA 構造体を割り当て、RtlZeroMemory 呼び出して構造体を 0 にしてから、適切なメンバーに値を割り当ててから、MCDInitData パラメーターを使用して ChangerClassInitialize を する構造体のアドレスを渡す必要があります。

必要条件

関連項目

MCD_INIT_DATA

RtlZeroMemory の