次の方法で共有

WdfPdoInitAllocate 関数 (wdfpdo.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfPdoInitAllocate メソッドは、フレームワーク ベースのバス ドライバーにWDFDEVICE_INIT構造体を割り当てます。この構造体は、バス ドライバーが新しいデバイスを報告するときに使用します。

構文

PWDFDEVICE_INIT WdfPdoInitAllocate(
  [in] WDFDEVICE ParentDevice
);

パラメーター

[in] ParentDevice

新しいデバイスの親デバイスを表すフレームワーク デバイス オブジェクトへのハンドル。 フレームワーク デバイス オブジェクトは、機能デバイス オブジェクト (FDO) を表す必要があります。

戻り値

操作が成功した場合、メソッドはフレームワークによって割り当てられた WDFDEVICE_INIT 構造体へのポインターを返します。 それ以外の場合、メソッドは NULL を返します。

注釈

バス ドライバーが静的列挙を使用する場合、次の方法で新しいデバイスが報告されます。

  1. WdfPdoInitAllocate を呼び出して、WDFDEVICE_INIT構造体を割り当てます。
  2. 必要 に応じて、フレームワーク デバイス オブジェクト初期化メソッド と フレームワーク PDO 初期化メソッドを呼び出して、WDFDEVICE_INIT構造体を初期化します。 これらのメソッドの呼び出しが失敗した場合、ドライバーは WdfDeviceInitFree を呼び出す必要があります。
  3. 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)

こちらもご覧ください

WdfControlDeviceInitAllocate