WDFDEVICE_INIT 構造体

[KMDF と UMDF に適用]

WDFDEVICE_INIT 構造体は、フレームワークによって定義および割り当てられる不透明な構造体です。

構文

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

関数ドライバーとフィルタードライバーは EvtDriverDeviceAdd コールバック関数への入力として、または WdfControlDeviceInitAllocateからの戻り値として、この構造体へのポインターを受け取ります。

バスドライバーは EvtChildListCreateDevice コールバック関数への入力として、または WdfPdoInitAllocateからの戻り値として構造体ポインターを受け取ります。

ドライバーは WDFDEVICE_INIT 構造体を受け取った後、構造体ポインターを初期化関数に渡します。これらの関数は WDFDEVICE_INIT 構造体を使用して、フレームワークデバイスオブジェクトの作成にフレームワークが使用する情報を格納します。

デバイス初期化メソッドのドキュメントについては wdfdevice.h header をご参照ください。

初期化関数を呼び出した後、ドライバーは WdfDeviceCreate を呼び出してフレームワークデバイスオブジェクトを作成する必要があります。

ドライバーが WdfPdoInitAllocate または WdfControlDeviceInitAllocate の呼び出しから WDFDEVICE_INIT 構造体を受り、さらに初期化関数の呼び出しからエラーを受け取った場合、ドライバーは WdfDeviceCreate ではなくWdfDeviceInitFree を呼び出す必要があります。

ドライバーは、WdfDeviceCreateへの呼び出しが成功した後、 WdfDeviceInitFree を呼び出してはなりません。

WDFDEVICE_INIT 構造は、バージョン 1.0 以降のバージョンの KMDF で使用できます。

ヘッダー	Wdftypes.h (Wdftypes.h を含む)