共用方式為


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

需求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標題 wdfpdo.h (包括 Wdf.h)
程式庫 Wdf01000.sys (請參閱架構連結庫版本控制。)
IRQL PASSIVE_LEVEL
DDI 合規性規則 AddPdoToStaticChildList(kmdf)DoubleDeviceInitFree(kmdf)DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf),PdoDeviceInitAPI(kmdf)PdoInitFreeDeviceCallback(kmdf)PdoInitFreeDeviceCreate(kmPdoInitFreeDeviceCreateType2(kmdf)PdoInitFreeDeviceCreateType4(kmdf)

另請參閱

WdfControlDeviceInitAllocate