_URB_CONTROL_DESCRIPTOR_REQUEST-Struktur (usb.h)

Die _URB_CONTROL_DESCRIPTOR_REQUEST-Struktur wird von USB-Clienttreibern verwendet, um Deskriptoren auf einem USB-Gerät abzurufen oder festzulegen.

Syntax

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;
};

Member

Hdr

Zeiger auf eine _URB_HEADER-Struktur , die die URB-Headerinformationen angibt. Hdr.Function muss eine der folgenden Sein:

Hdr.Length muss gleich sizeof(_URB_CONTROL_DESCRIPTOR_REQUEST)sein.

Reserved

Reserviert. Darf nicht verwendet werden.

Reserved0

Reserviert. Darf nicht verwendet werden.

TransferBufferLength

Gibt die Länge des Puffers in Bytes an, der in TransferBuffer angegeben oder in TransferBufferMDL beschrieben wird. Der Hostcontrollertreiber gibt die Anzahl der Bytes zurück, die an die Pipe in diesem Element gesendet oder aus dieser gelesen werden.

TransferBuffer

Zeiger auf einen residenten Puffer für die Übertragung oder ist NULL , wenn eine MDL in TransferBufferMDL bereitgestellt wird.

TransferBufferMDL

Zeiger auf eine MDL, die einen residenten Puffer beschreibt, oder ist NULL , wenn ein Puffer in TransferBuffer bereitgestellt wird. Diese MDL muss aus einem nicht auslagerten Pool zugeordnet werden.

UrbLink

Reserviert. Darf nicht verwendet werden.

hca

Reserviert. Darf nicht verwendet werden.

Reserved1

Reserviert. Darf nicht verwendet werden.

Index

Gibt den gerätedefinierten Index des Deskriptors an, der abgerufen oder festgelegt wird.

DescriptorType

Gibt an, welcher Deskriptortyp abgerufen oder festgelegt wird. Einer der folgenden Werte muss angegeben werden:

LanguageId

Gibt die Sprach-ID des Deskriptors an, der abgerufen werden soll, wenn USB_STRING_DESCRIPTOR_TYPE in DescriptorType festgelegt ist. Dieser Member muss für jeden anderen Wert in DescriptorType auf Null festgelegt werden.

Reserved2

Reserviert. Darf nicht verwendet werden.

Hinweise

Treiber können die UsbBuildGetDescriptorRequest-Dienstroutine verwenden, um diese URB zu formatieren. Wenn der Aufrufer einen Puffer übergibt, der zu klein ist, um alle Daten aufzunehmen, schneidet der Bustreiber die Daten ab, um in den Puffer ohne Fehler zu passen.

Wenn der Aufrufer den Gerätedeskriptor anfordert, gibt der Bustreiber eine USB_DEVICE_DESCRIPTOR Datenstruktur zurück.

Wenn der Aufrufer einen Konfigurationsdeskriptor anfordert, gibt der Bustreiber den Konfigurationsdeskriptor in einer USB_CONFIGURATION_DESCRIPTOR-Struktur zurück, gefolgt von den Schnittstellen- und Endpunktdeskriptoren für diese Konfiguration. Der Treiber kann auf die Schnittstellen- und Endpunktdeskriptoren als USB_INTERFACE_DESCRIPTOR - und USB_ENDPOINT_DESCRIPTOR-Strukturen zugreifen. Der Bustreiber gibt auch alle klassenspezifischen oder gerätespezifischen Deskriptoren zurück. Das System stellt die USBD_ParseConfigurationDescriptorEx und USBD_ParseDescriptors Dienstroutinen bereit, um einzelne Deskriptoren im Puffer zu finden.

Wenn der Aufrufer einen Zeichenfolgendeskriptor anfordert, gibt der Bustreiber eine USB_STRING_DESCRIPTOR-Struktur zurück. Die Zeichenfolge selbst befindet sich im bString-Member mit variabler Länge des Zeichenfolgendeskriptors.

Die reservierten Member dieser Struktur müssen als undurchsichtig behandelt werden und sind für die Systemverwendung reserviert.

Anforderungen

Weitere Informationen

URB

USB-Strukturen

USB_CONFIGURATION_DESCRIPTOR

USB_DEVICE_DESCRIPTOR

USB_ENDPOINT_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

USB_STRING_DESCRIPTOR

_URB_HEADER