IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

[アーティクル]
03/05/2024

この要求は、トランスポート特性の変更に関する通知に登録されます。

メジャーコード

入力/出力バッファー

AssociatedIrp.SystemBuffer メンバーは、USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION構造体へのポインターです。入力時に、クライアントドライバーは ChangeNotificationInputFlags メンバーにフラグを設定することで、ドライバーが関心を持つ通知変更の種類を指定できます。

出力時に、構造体には、トランスポート特性の登録ハンドルと初期値が入力されます。

入力/出力バッファーの長さ

USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION構造体のサイズ。

ステータスブロック

Irp->要求が成功した場合、IoStatus.Status はSTATUS_SUCCESSに設定されます。それ以外の場合、 Status は NTSTATUS コードとして適切なエラー状態を示します。

注釈

MA-USB メディアのトランスポート特性は、時間の経過と同時に大きく異なる場合があります。クライアントダイバーが常に最新の情報を把握することに関心がある場合、ドライバーは要求を送信して通知を登録する必要があります。

この要求は、ユーザーモードアプリケーション、UMDF ドライバー、または KMDF ドライバーによって送信できます。 USB ドライバースタックは、古い登録ハンドルと不適切な登録ハンドルを確認します。登録前と登録解除後にハンドルで要求を受信した場合、ドライバースタックは要求に失敗します。

要件

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