共用方式為

UdecxWdfDeviceTryHandleUserIoctl 函式 （udecxwdfdevice.h）

  • 發行項

嘗試處理使用者模式軟體所傳送的IOCTL要求。

語法

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

參數

UdecxWdfDevice

表示控制器之架構裝置物件的句柄。 用戶端驅動程式在先前呼叫 UdecxWdfDeviceAddUsbDeviceEmulation 中初始化這個物件。

[in] Request

表示 IOCTL 要求的架構要求物件的句柄。

傳回值

TRUE 表示 USB 裝置模擬類別延伸模組 （UdeCx） 已辨識並完成要求（成功或失敗）。 在此情況下，客戶端驅動程式不得完成要求。 否則為 FALSE;驅動程式必須完成要求。

言論

UDE 用戶端驅動程式會將自己呈現為主控制器驅動程式的使用者模式軟體。 用戶端驅動程式會註冊並公開GUID_DEVINTERFACE_USB_HOST_CONTROLLER裝置介面 GUID。 使用者模式軟體可以藉由指定 GUID 來開啟裝置的句柄。 透過使用該句柄，軟體可以傳送IOCTL要求。

注意 請注意，其他介面的IOCTL代碼可能會與USB主機控制器介面重疊。 如果這類 I/O 到達此函式，IOCTL 將無法正確處理。
 
用戶端驅動程式不需要處理收到的IOCTL。 它可以呼叫 UdecxWdfDeviceTryHandleUserIoctl，將要求傳送至類別延伸模組。 如果類別延伸模組將要求辨識為標準要求，則會完成要求。 否則，呼叫會失敗，然後用戶端驅動程式預期會完成要求。 如需必須處理的 IOCTL 清單，請參閱 應用程式與服務的 USB IOCTL。

要求

要求 價值
最低支援的用戶端 Windows 10
支援的最低伺服器 Windows Server 2016
目標平臺 窗戶
最低 KMDF 版本 1.15
標頭 udecxwdfdevice.h （include Udecx.h）
連結庫 Udecxstub.lib
IRQL PASSIVE_LEVEL

另請參閱

架構：USB 裝置模擬 （UDE）

寫入 UDE 用戶端驅動程式