WdfPdoInitAllocate 関数 (wdfpdo.h)
[KMDF にのみ適用]
WdfPdoInitAllocate メソッドは、フレームワーク ベースのバス ドライバーにWDFDEVICE_INIT構造体を割り当てます。この構造体は、バス ドライバーが新しいデバイスを報告するときに使用します。
構文
PWDFDEVICE_INIT WdfPdoInitAllocate(
[in] WDFDEVICE ParentDevice
);
パラメーター
[in] ParentDevice
新しいデバイスの親デバイスを表すフレームワーク デバイス オブジェクトへのハンドル。 フレームワーク デバイス オブジェクトは、機能デバイス オブジェクト (FDO) を表す必要があります。
戻り値
操作が成功した場合、メソッドはフレームワークによって割り当てられた WDFDEVICE_INIT 構造体へのポインターを返します。 それ以外の場合、メソッドは NULL を返します。
注釈
バス ドライバーが静的列挙を使用する場合、次の方法で新しいデバイスが報告されます。
- WdfPdoInitAllocate を呼び出して、WDFDEVICE_INIT構造体を割り当てます。
- 必要 に応じて、フレームワーク デバイス オブジェクト初期化メソッド と フレームワーク PDO 初期化メソッドを呼び出して、WDFDEVICE_INIT構造体を初期化します。 これらのメソッドの呼び出しが失敗した場合、ドライバーは WdfDeviceInitFree を呼び出す必要があります。
- WdfDeviceCreate を呼び出してフレームワーク デバイス オブジェクトを作成し、初期化されたWDFDEVICE_INIT構造体を入力として指定します。
例
WdfPdoInitAllocate を使用するコード例については、「WdfFdoAddStaticChild」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfpdo.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | AddPdoToStaticChildList(kmdf), DoubleDeviceInitFree(kmdf), DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 PdoDeviceInitAPI(kmdf)、 PdoInitFreeDeviceCallback(kmdf)、 PdoInitFreeDeviceCreate(kmdf)、 PdoInitFreeDeviceCreateType2(kmdf)、 PdoInitFreeDeviceCreateType4(kmdf) |