WdfFdoInitWdmGetPhysicalDevice 函式 （wdffdo.h）
[僅適用於 KMDF]
WdfFdoInitWdmGetPhysicalDevice 方法會擷取裝置的 WDM 實體裝置物件 （PDO）。
語法
PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
[in] PWDFDEVICE_INIT DeviceInit
);
參數
[in] DeviceInit
驅動程式從其 EvtDriverDeviceAdd 回呼函式取得之 WDFDEVICE_INIT 結構的指標。
返回值
如果作業成功，方法會傳回 DEVICE_OBJECT 結構的指標。 否則，方法會傳回 NULL 。
備註
驅動程式必須先呼叫 WdfFdoInitWdmGetPhysicalDevice，才能呼叫 WdfDeviceCreate。 如需呼叫 WdfDeviceCreate的詳細資訊，請參閱 建立 Framework Device Object。
如需 WdfFdoInitWdmGetPhysicalDevice 方法的詳細資訊，請參閱 在函式驅動程式中建立裝置物件。
範例
下列程式代碼範例會取得代表裝置 WDM PDO 之DEVICE_OBJECT結構的指標。
PDEVICE_OBJECT device;
device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標題 | wdffdo.h （包括 Wdf.h） |
| 程式庫 | Wdf01000.sys （請參閱架構連結庫版本控制。） |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DeviceInitAPI（kmdf），DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |