IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)
此要求會註冊傳輸特性變更的相關通知。
主要程序代碼
輸入/輸出緩衝區
AssociatedIrp.SystemBuffer 成員是USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION結構的指標。 在輸入時,客戶端驅動程式可以藉由在 ChangeNotificationInputFlags 成員中設定旗標來指定驅動程式感興趣的通知變更類型。
在輸出中,結構會填入註冊句柄和傳輸特性的初始值。
輸入/輸出緩衝區長度
USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION 結構的大小。
狀態區塊
Irp->如果要求成功,IoStatus.Status 會設定為 STATUS_SUCCESS。 否則, Status 會以 NTSTATUS 程式代碼表示適當的錯誤狀況。
備註
MA-USB 媒體的傳輸特性可能會隨著時間而大幅改變。 如果用戶端 diver 想要隨時瞭解最新資訊,驅動程式必須藉由傳送要求來註冊通知。
此要求可由使用者模式應用程式、UMDF 驅動程式或 KMDF 驅動程式傳送。 USB 驅動程式堆疊會檢查過時和不正確的註冊句柄。 如果在註冊前和取消註冊之後於句柄上收到要求,驅動程式堆疊會失敗要求。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1709) |
最低支援的伺服器 | Windows Server 2016 |
標頭 | usbioctl.h |
IRQL | <=DISPATCH_LEVEL |
另請參閱
適用於 Media-Agnostic (MA-USB) 的 USB 用戶端驅動程式
WdfIoTargetSendInternalIoctlOthersSynchronously