wdfiotarget.h 標頭

wdf 會使用此標頭。 如需詳細資訊，請參閱

• Windows 驅動程式架構

wdfiotarget.h 包含下列程式設計介面：

函式

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME函式會初始化驅動程式的WDF_IO_TARGET_OPEN_PARAMS結構，讓驅動程式可以藉由指定裝置、檔案或裝置介面的名稱來開啟 I/O 目標。
WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE函式會初始化驅動程式的WDF_IO_TARGET_OPEN_PARAMS結構，讓驅動程式可以指定 Windows 驅動程式模型 (WDM) 裝置物件來開啟遠端 I/O 目標。
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE函式會初始化驅動程式的WDF_IO_TARGET_OPEN_PARAMS結構，讓驅動程式可以指定檔案名來開啟 I/O 目標。
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME函式會初始化驅動程式的WDF_IO_TARGET_OPEN_PARAMS結構，讓驅動程式可以藉由指定裝置、檔案或裝置介面的名稱來開啟 I/O 目標。
WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN函式會初始化驅動程式的WDF_IO_TARGET_OPEN_PARAMS結構，讓驅動程式可以重新開啟遠端 I/O 目標。
WdfIoTargetAllocAndQueryTargetProperty WdfIoTargetAllocAndQueryTargetProperty 方法會配置緩衝區，並擷取指定 I/O 目標的指定裝置屬性。
WdfIoTargetClose WdfIoTargetClose 方法會關閉指定的遠端 I/O 目標。
WdfIoTargetCloseForQueryRemove WdfIoTargetCloseForQueryRemove 方法會暫時關閉指定的遠端 I/O 目標，因為目標裝置可能很快就會移除。
WdfIoTargetCreate WdfIoTargetCreate 方法會為指定的裝置建立遠端 I/O 目標。
WdfIoTargetFormatRequestForInternalIoctl WdfIoTargetFormatRequestForInternalIoctl 方法會建置 I/O 目標的內部裝置控制要求，但不會傳送要求。
WdfIoTargetFormatRequestForInternalIoctlOthers WdfIoTargetFormatRequestForInternalIoctlOthers 方法會建置 I/O 目標的非標準內部裝置控制要求，但不會傳送要求。
WdfIoTargetFormatRequestForIoctl WdfIoTargetFormatRequestForIoctl 方法會建置 I/O 目標的裝置控制要求，但不會傳送要求。
WdfIoTargetFormatRequestForRead WdfIoTargetFormatRequestForRead 方法會建置 I/O 目標的讀取要求，但不會傳送要求。
WdfIoTargetFormatRequestForWrite WdfIoTargetFormatRequestForWrite 方法會建置 I/O 目標的寫入要求，但不會傳送要求。
WdfIoTargetGetDevice WdfIoTargetGetDevice 方法會傳回架構裝置物件的控制碼，該物件是指定本機或遠端 I/O 目標的父代。
WdfIoTargetGetState WdfIoTargetGetState 方法會傳回本機或遠端 I/O 目標的狀態資訊。
WdfIoTargetOpen WdfIoTargetOpen 方法會開啟遠端 I/O 目標，讓驅動程式可以傳送 I/O 要求給它。
WdfIoTargetPurge WdfIoTargetPurge 方法會取消排入本機、遠端或特製化 I/O 目標的所有 I/O 要求，並防止任何新的 I/O 要求排入佇列。
WdfIoTargetQueryForInterface WdfIoTargetQueryForInterface 方法可存取遠端 I/O 目標的 GUID 識別、驅動程式定義介面。
WdfIoTargetQueryTargetProperty WdfIoTargetQueryTargetProperty 方法會擷取指定 I/O 目標的指定裝置屬性。
WdfIoTargetSendInternalIoctlOthersSynchronously WdfIoTargetSendInternalIoctlOthersSynchronously 方法會建置非標準內部裝置控制要求，並將它同步傳送至 I/O 目標。
WdfIoTargetSendInternalIoctlSynchronously WdfIoTargetSendInternalIoctlSynchronously 方法會建置內部裝置控制要求，並將它同步傳送至 I/O 目標。
WdfIoTargetSendIoctlSynchronously WdfIoTargetSendIoctlSynchronously 方法會建置裝置控制項要求，並將它同步傳送至 I/O 目標。
WdfIoTargetSendReadSynchronously WdfIoTargetSendReadSynchronously 方法會建置讀取要求，並將它同步傳送至 I/O 目標。
WdfIoTargetSendWriteSynchronously WdfIoTargetSendWriteSynchronously 方法會建置寫入要求，並將它同步傳送至 I/O 目標。
WdfIoTargetStart WdfIoTargetStart 方法會開始將佇列要求傳送至本機或遠端 I/O 目標。
WdfIoTargetStop WdfIoTargetStop 方法會停止將佇列要求傳送至本機或遠端 I/O 目標。
WdfIoTargetWdmGetTargetDeviceObject WdfIoTargetWdmGetTargetDeviceObject 方法會傳回與指定本機或遠端 I/O 目標相關聯的 Windows 驅動程式模型 (WDM) 裝置物件的指標。
WdfIoTargetWdmGetTargetFileHandle WdfIoTargetWdmGetTargetFileHandle 方法會傳回與指定遠端 I/O 目標相關聯的檔案控制碼。
WdfIoTargetWdmGetTargetFileObject WdfIoTargetWdmGetTargetFileObject 方法會傳回與指定遠端 I/O 目標相關聯的 Windows 驅動程式模型 (WDM) 檔案物件的指標。
WdfIoTargetWdmGetTargetPhysicalDevice WdfIoTargetWdmGetTargetPhysicalDevice 方法會傳回 Windows 驅動程式模型 (WDM) 實體裝置物件的指標， (PDO) 代表遠端 I/O 目標的裝置。

回呼函式

EVT_WDF_IO_TARGET_QUERY_REMOVE 驅動程式的 EvtIoTargetQueryRemove 事件回呼函式指出架構是否可以安全地移除指定的遠端 I/O 目標裝置。
EVT_WDF_IO_TARGET_REMOVE_CANCELED 驅動程式的 EvtIoTargetRemoveCanceled 事件回呼函式會在移除指定的遠端 I/O 目標取消時執行作業。
EVT_WDF_IO_TARGET_REMOVE_COMPLETE 驅動程式的 EvtIoTargetRemoveComplete 事件回呼函式會在移除指定的遠端 I/O 目標完成時執行作業。

結構

WDF_IO_TARGET_OPEN_PARAMS WDF_IO_TARGET_OPEN_PARAMS 結構包含 WdfIoTargetOpen 方法所使用的參數。

列舉

WDF_IO_TARGET_OPEN_TYPE WDF_IO_TARGET_OPEN_TYPE列舉會指定驅動程式呼叫 WdfIoTargetOpen 時，驅動程式如何識別遠端 I/O 目標。
WDF_IO_TARGET_PURGE_IO_ACTION WDF_IO_TARGET_PURGE_IO_ACTION列舉可識別驅動程式呼叫 WdfIoTargetPurge 以清除 I/O 目標時，架構可以採取的動作。
WDF_IO_TARGET_SENT_IO_ACTION WDF_IO_TARGET_SENT_IO_ACTION列舉可識別當驅動程式呼叫 WdfIoTargetStop 以停止 I/O 目標時，架構可以採取的動作。
WDF_IO_TARGET_STATE WDF_IO_TARGET_STATE列舉會指定 I/O 目標可以位於的狀態。