_URB_CONTROL_DESCRIPTOR_REQUEST構造体 (usb.h)

[アーティクル]
08/07/2023

_URB_CONTROL_DESCRIPTOR_REQUEST構造体は、USB デバイスで記述子を取得または設定するために USB クライアントドライバーによって使用されます。

構文

struct _URB_CONTROL_DESCRIPTOR_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved0;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  USHORT               Reserved1;
  UCHAR                Index;
  UCHAR                DescriptorType;
  USHORT               LanguageId;
  USHORT               Reserved2;
};

メンバー

Hdr

URB ヘッダー情報を指定する _URB_HEADER 構造体へのポインター。 Hdr.Function は、次のいずれかである必要があります。

Hdr.Length はと等しい sizeof(_URB_CONTROL_DESCRIPTOR_REQUEST)必要があります。

Reserved

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

Reserved0

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

TransferBufferLength

TransferBuffer またはTransferBufferMDL で説明されているバッファーの長さをバイト単位で指定します。ホストコントローラードライバーは、このメンバーのパイプに送信またはパイプから読み取られたバイト数を返します。

TransferBuffer

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

TransferBufferMDL

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

UrbLink

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

hca

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

Reserved1

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

Index

取得または設定される記述子のデバイス定義インデックスを指定します。

DescriptorType

取得または設定されている記述子の種類を示します。次のいずれかの値を指定する必要があります。

usbspec.h 定数	値	USB バージョン
USB_DEVICE_DESCRIPTOR_TYPE	0x01	USB 1.1
USB_CONFIGURATION_DESCRIPTOR_TYPE	0x02	USB 1.1
USB_STRING_DESCRIPTOR_TYPE	0x03	USB 1.1
USB_INTERFACE_DESCRIPTOR_TYPE	0x04	USB 1.1
USB_ENDPOINT_DESCRIPTOR_TYPE	0x05	USB 1.1
USB_DEVICE_QUALIFIER_DESCRIPTOR_TYPE	0x06	USB 2.0
USB_OTHER_SPEED_CONFIGURATION_DESCRIPTOR_TYPE	0x07	USB 2.0
USB_INTERFACE_POWER_DESCRIPTOR_TYPE	0x08	USB 2.0
USB_OTG_DESCRIPTOR_TYPE	0x09	USB 3.0
USB_DEBUG_DESCRIPTOR_TYPE	0x0a	USB 3.0
USB_INTERFACE_ASSOCIATION_DESCRIPTOR_TYPE	0x0b	USB 3.0
USB_BOS_DESCRIPTOR_TYPE	0x0f	USB 3.0
USB_DEVICE_CAPABILITY_DESCRIPTOR_TYPE	0x10	USB 3.0
USB_SUPERSPEED_ENDPOINT_COMPANION_DESCRIPTOR_TYPE	0x30	USB 3.0
USB_20_HUB_DESCRIPTOR_TYPE	0x29	USB 1.1 USB 2.0
USB_30_HUB_DESCRIPTOR_TYPE	0x2a	USB 3.0
USB_SUPERSPEEDPLUS_ISOCH_ENDPOINT_COMPANION_DESCRIPTOR_TYPE	0x31	USB 3.1

LanguageId

DescriptorType でUSB_STRING_DESCRIPTOR_TYPEが設定されている場合に取得する記述子の言語 ID を指定します。 DescriptorType の他の値については、このメンバーを 0 に設定する必要があります。

Reserved2

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

注釈

ドライバーは 、UsbBuildGetDescriptorRequest サービスルーチンを使用して、この URB の書式を設定できます。呼び出し元がバッファーを渡してすべてのデータを保持するには小さすぎる場合、バスドライバーはエラーなくバッファーに収まるようにデータを切り捨てます。

呼び出し元がデバイス記述子を要求すると、バスドライバーは USB_DEVICE_DESCRIPTOR データ構造を返します。

呼び出し元が構成記述子を要求すると、バスドライバーは、その構成のインターフェイスとエンドポイント記述子の後に、USB_CONFIGURATION_DESCRIPTOR構造体の構成記述子を返します。ドライバーは、USB_INTERFACE_DESCRIPTORおよび USB_ENDPOINT_DESCRIPTOR 構造体としてインターフェイス記述子とエンドポイント記述子にアクセスできます。バスドライバーは、クラス固有またはデバイス固有の記述子も返します。システムは、バッファー内の個々の記述子を検索するための USBD_ParseConfigurationDescriptorExおよびUSBD_ParseDescriptors サービスルーチンを提供します。

呼び出し元が文字列記述子を要求すると、バスドライバーは USB_STRING_DESCRIPTOR 構造体を返します。文字列自体は、文字列記述子の可変長 bString メンバーにあります。

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