WdfDeviceGetIoTarget 函式 （wdfdevice.h）
[適用於 KMDF 和 UMDF]
WdfDeviceGetIoTarget 方法會針對指定的裝置傳回函式或篩選驅動程式 本機 I/O 目標的句柄。
語法
WDFIOTARGET WdfDeviceGetIoTarget(
[in] WDFDEVICE Device
);
參數
[in] Device
架構裝置物件的句柄。
傳回值
如果作業成功，WdfDeviceGetIoTarget 傳回架構 I/O 目標物件的句柄。 如果指定的架構裝置物件代表 PDO，此方法會傳回 null 。
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
言論
當 UMDF 驅動程式將驅動程式建立的要求傳送至本機 I/O 目標時，要求沒有相關聯的檔案物件。 某些較低的目標，例如 HIDClass 列舉的原始 PDO，失敗要求沒有相關聯的檔案物件。 在此情況下，UMDF 驅動程式可以指定 WdfIoTargetOpenLocalTargetByFile 來建立 I/O 目標，代表較低堆棧（就像本機目標一樣）使用檔句柄。 因此，傳送至此 I/O 目標的任何驅動程式建立要求都會與對應至開啟句柄的檔案對象相關聯。
若要這樣做，請先呼叫 WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE 函式，再呼叫 WdfIoTargetOpen。
例子
下列程式代碼範例會取得指定裝置本機 I/O 目標的句柄。
WDFIOTARGET ioTargetHandle;
ioTargetHandle = WdfDeviceGetIoTarget(device);
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 標頭 | wdfdevice.h （包括 Wdf.h） |
| 連結庫 | Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF） |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |