IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

此要求會註冊傳輸特性變更的相關通知。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入/輸出緩衝區

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

另請參閱

在驅動程式中建立IOCTL要求

適用於 Media-Agnostic (MA-USB) 的 USB 用戶端驅動程式

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously