_URB_CONTROL_GET_STATUS_REQUEST-Struktur (usb.h)

Die _URB_CONTROL_GET_STATUS_REQUEST-Struktur wird von USB-Clienttreibern verwendet, um status von einem Gerät, einer Schnittstelle, einem Endpunkt oder einem anderen gerätedefiniertem Ziel abzurufen.

Syntax

struct _URB_CONTROL_GET_STATUS_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved0;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  UCHAR                Reserved1[4];
  USHORT               Index;
  USHORT               Reserved2;
};

Member

Hdr

Zeiger auf eine _URB_HEADER-Struktur , die die URB-Headerinformationen angibt. Hdr.Length muss sein sizeof(_URB_CONTROL_GET_STATUS_REQUEST), und Hdr.Function muss einer der folgenden Werte sein:

• URB_FUNCTION_GET_STATUS_FROM_DEVICE
• URB_FUNCTION_GET_STATUS_FROM_INTERFACE
• URB_FUNCTION_GET_STATUS_FROM_ENDPOINT
• URB_FUNCTION_GET_STATUS_FROM_OTHER

Reserved

Reserviert. Darf nicht verwendet werden.

Reserved0

Reserviert. Darf nicht verwendet werden.

TransferBufferLength

Muss 2 sein. Dieser Member 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 Member 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. Der Bustreiber gibt ein einzelnes Byte zurück, das die status für das Ziel angibt.

TransferBufferMDL

Zeiger auf eine MDL, die einen residenten Puffer beschreibt, oder null ist, wenn ein Puffer in TransferBuffer bereitgestellt wird. Der Bustreiber gibt ein einzelnes Byte zurück, das die status für das Ziel angibt. Diese MDL muss aus einem nicht ausseitigen Pool zugeordnet werden.

UrbLink

Reserviert. Darf nicht verwendet werden.

hca

Reserviert. Darf nicht verwendet werden.

Reserved1[4]

Reserviert. Darf nicht verwendet werden.

Index

Gibt den gerätedefinierten Index an, der von einer erfolgreichen Konfigurationsanforderung zurückgegeben wird, wenn die Anforderung für einen Endpunkt oder eine Schnittstelle gilt. Andernfalls muss der Index null sein.

Reserved2

Reserviert. Darf nicht verwendet werden.

Hinweise

Treiber können die UsbBuildGetStatusRequest-Dienstroutine verwenden, um diese URB zu formatieren.

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

Anforderungen

Anforderung	Wert
Header	usb.h (usb.h einschließen)

Weitere Informationen

URB

USB-Strukturen

_URB_HEADER