クライアント ドライバーは、トランスポート特性を取得するためにこの要求を送信します。
メジャー コード
入力/出力バッファー
AssociatedIrp.SystemBuffer メンバーは、呼び出し元によって割り当てられた USB_TRANSPORT_CHARACTERISTICS 構造体へのポインターです。 入力時に、バージョン を USB_TRANSPORT_CHARACTERISTICS_VERSION_1 に設定します。 出力 バージョン は、USB_TRANSPORT_CHARACTERISTICS_VERSION_1以下のバージョンにリセットされます。彼は構造の残りのメンバーは、トランスポート情報で満たされています。
入力/出力バッファーの長さ
USB_TRANSPORT_CHARACTERISTICS 構造体のサイズ。
状態ブロック
Irp->IoStatus.Status は、要求が成功した場合にSTATUS_SUCCESSに設定されます。 それ以外の場合は、状態 NTSTATUS コードとして適切なエラー状態に します。
備考
この要求は、ストリーミング用のアルゴリズムを決定するトランスポート特性を取得します。 たとえば、ディスプレイ ドライバーは、待機時間と帯域幅の情報を使用して、コーデックの選択を決定できます。
この情報は、常に使用できるとは限りません。 USB ドライバー スタックは、これらの値を公開する基になるトランスポートに依存します。 そのため、クライアント ドライバーには、要求が発生した場合のバックアップ メカニズムが必要です。
クライアント ドライバーが常に最新の情報を知ることに関心がある場合、ドライバーは、トランスポート特性が変更されたときに通知を登録し、USB ドライバー スタックで保留中の要求を保持し、通知が不要になったときに登録を解除する必要があります。 ドライバーは、これらの IOCTL 要求を送信することによって、これらのすべてのタスクを実行できます。
- IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE
- IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE
- IOCTL_USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 10 バージョン 1709 |
サポートされる最小サーバー | Windows Server 2016 |
ヘッダー | usbioctl.h |
IRQL | <=DISPATCH_LEVEL |
関連項目
ドライバー での IOCTL 要求の作成の
Media-Agnostic (MA-USB) 用の USB クライアント ドライバーを する
WdfIoTargetSendInternalIoctlOthersSynchronously を する
WdfIoTargetSendInternalIoctlSynchronously
WdfIoTargetSendIoctlSynchronously を する