WdfIoTargetGetDevice 函式 (wdfiotarget.h)
[適用於 KMDF 和 UMDF]
WdfIoTargetGetDevice 方法會將句柄傳回為指定本機或遠端 I/O 目標的父系架構裝置物件。
語法
WDFDEVICE WdfIoTargetGetDevice(
[in] WDFIOTARGET IoTarget
);
參數
[in] IoTarget
I/O 目標物件的句柄。 此句柄是從 WdfDeviceGetIoTarget、WdfIoTargetCreate,或從 特製化 I/O 目標 提供的方法取得(例如 WdfUsbTargetDeviceGetIoTarget)。
返回值
WdfIoTargetGetDevice 傳回架構裝置物件的句柄。
如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。
備註
如需 WdfIoTargetGetDevice的詳細資訊,請參閱 取得一般 I/O 目標的相關信息。
範例
下列程式代碼範例顯示 EvtIoTargetQueryRemove 回呼函式如何呼叫 WdfIoTargetGetDevice。
NTSTATUS
MyEvtIoTargetQueryRemove(
WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}
需求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
標題 | wdfiotarget.h (包括 Wdf.h) |
程式庫 | Wdf01000.sys (KMDF):WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
DDI 合規性規則 | DriverCreate(kmdf),KmdfIrql(kmdf),KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf) |