[僅適用於 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結構作為輸入。
範例
如需使用 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(km,PdoInitFreeDeviceCreateType2(kmdf),PdoInitFreeDeviceCreateType4(kmdf) |