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

要件

要件 値
対象プラットフォーム デスクトップ
Header mcd.h (Mcd.h、Ntddchgr.h を含む)
Library Mcd.lib

こちらもご覧ください

MCD_INIT_DATA

RtlZeroMemory