_URB_OS_FEATURE_DESCRIPTOR_REQUEST-Struktur (usb.h)

  • Artikel

Die _URB_OS_FEATURE_DESCRIPTOR_REQUEST-Struktur wird vom USB-Hubtreiber verwendet, um Microsoft-Betriebssystem-Featuredeskriptoren von einem USB-Gerät oder einer Schnittstelle auf einem USB-Gerät abzurufen.

Syntax

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

Member

Hdr

Zeiger auf eine _URB_HEADER-Struktur , die die URB-Headerinformationen angibt. Hdr.Function muss URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR. Hdr.Length muss sein sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST).

Reserved

Reserved0

TransferBufferLength

Gibt die Länge des in TransferBuffer angegebenen oder in TransferBufferMDL beschriebenen Puffers in Bytes an. Der Hostcontrollertreiber gibt die Anzahl der in diesem Member gelesenen Bytes zurück. Bei der aktuellen Implementierung dieser Funktion wird die maximale Ms OS-Featuredeskriptorgröße auf 4 Kb beschränkt.

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 null ist, wenn ein Puffer in TransferBuffer bereitgestellt wird. Diese MDL muss aus einem nicht ausseitigen Pool zugeordnet werden.

UrbLink

Reserviert. Darf nicht verwendet werden.

hca

Recipient

Gibt an, ob der Empfänger das USB-Gerät oder eine Schnittstelle auf dem USB-Gerät ist. Einer der folgenden Werte muss angegeben werden:

  • 0 gibt an, dass das USB-Gerät der Empfänger der Anforderung ist.
  • 1 gibt an, dass eine USB-Schnittstelle der Empfänger der Anforderung ist.
  • 2 gibt an, dass ein USB-Endpunkt der Empfänger der Anforderung ist.

Reserved1

Reserved2

InterfaceNumber

Gibt die Schnittstellennummer an, die der Empfänger der Anforderung ist, wenn der Recipient-Memberwert 1 ist. Muss auf 0 festgelegt werden, wenn das USB-Gerät der Empfänger ist.

MS_PageIndex

Muss auf 0 festgelegt werden. Seitenindex der 64K-Seite des zurückzugebenden MS OS-Featuredeskriptors. Die aktuelle Implementierung unterstützt nur eine maximale Deskriptorgröße von 4K.

MS_FeatureDescriptorIndex

Index für ms os feature descriptor to be requested.

Reserved3

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows XP und höheren Betriebssystemen.
Kopfzeile usb.h (usb.h einschließen)

Weitere Informationen

URB

_URB_HEADER