次の方法で共有


IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS IOCTL (usbioctl.h)

クライアント ドライバーは、トランスポート特性を取得するためにこの要求を送信します。

メジャー コード

IRP_MJ_DEVICE_CONTROL

入力/出力バッファー

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 要求を送信することによって、これらのすべてのタスクを実行できます。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 1709
サポートされる最小サーバー Windows Server 2016
ヘッダー usbioctl.h
IRQL <=DISPATCH_LEVEL

関連項目

ドライバー での IOCTL 要求の作成の

Media-Agnostic (MA-USB) 用の USB クライアント ドライバーを する

WdfIoTargetSendInternalIoctlOthersSynchronously する

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously する