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結構做為輸入。
如需靜態列舉的詳細資訊，請參閱 列舉總線上的裝置。

範例

如需使用 WdfPdoInitAllocate 的程式代碼範例，請參閱 WdfFdoAddStaticChild。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
標頭 wdfpdo.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
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