共用方式為


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