_URB_OS_FEATURE_DESCRIPTOR_REQUEST構造体 (usb.h)

  • [アーティクル]

_URB_OS_FEATURE_DESCRIPTOR_REQUEST構造体は、USB ハブ ドライバーによって使用され、USB デバイスまたは USB デバイス上のインターフェイスから Microsoft OS 機能記述子を取得します。

構文

struct _URB_OS_FEATURE_DESCRIPTOR_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved0;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  UCHAR                Recipient : 5;
  UCHAR                Reserved1 : 3;
  UCHAR                Reserved2;
  UCHAR                InterfaceNumber;
  UCHAR                MS_PageIndex;
  USHORT               MS_FeatureDescriptorIndex;
  USHORT               Reserved3;
};

メンバー

Hdr

URB ヘッダー情報を指定する _URB_HEADER 構造体へのポインター。 Hdr.Function を URB_FUNCTION_GET_MS_FEATURE_DESCRIPTORする必要があります。 Hdr.Length は である sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST)必要があります。

Reserved

Reserved0

TransferBufferLength

TransferBuffer で指定されたバッファーまたは TransferBufferMDL で説明されているバッファーの長さをバイト単位で指定します。 ホスト コントローラー ドライバーは、このメンバーで読み取られたバイト数を返します。 この関数の現在の実装では、MS OS 機能記述子の最大サイズが 4 KB に制限されています。

TransferBuffer

転送の常駐バッファーへのポインター。MDL が TransferBufferMDL で指定されている場合は NULL です。

TransferBufferMDL

常駐バッファーを記述する MDL へのポインター。バッファーが TransferBuffer で指定されている場合は NULL です。 この MDL は、非ページ プールから割り当てる必要があります。

UrbLink

予約済み。 使用しないでください。

hca

Recipient

受信者が USB デバイスであるか、USB デバイス上のインターフェイスであるかを指定します。 次のいずれかの値を指定する必要があります。

  • 0 は、USB デバイスが要求の受信者であることを示します。
  • 1 は、USB インターフェイスが要求の受信者であることを示します。
  • 2 は、USB エンドポイントが要求の受信者であることを示します。

Reserved1

Reserved2

InterfaceNumber

Recipient メンバー値が 1 の場合、要求の受信者であるインターフェイス番号を示します。 USB デバイスが受信者の場合は、0 に設定する必要があります。

MS_PageIndex

0 に設定する必要があります。 返される MS OS 機能記述子の 64K ページのページ インデックス。 現在の実装では、4K の最大記述子サイズのみがサポートされています。

MS_FeatureDescriptorIndex

要求される MS OS 機能記述子のインデックス。

Reserved3

注釈

この構造体の予約済みメンバーは不透明として扱う必要があり、システム使用のために予約されています。

要件

要件 値
サポートされている最小のクライアント Windows XP 以降のオペレーティング システムで使用できます。
Header usb.h (Usb.h を含む)

こちらもご覧ください

Urb

_URB_HEADER