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構造体を入力として指定します。

静的列挙の詳細については、「 Bus 上のデバイスの列挙」を参照してください。

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)