_URB_CONTROL_TRANSFER-Struktur (usb.h)

Artikel
08/07/2023

Die _URB_CONTROL_TRANSFER-Struktur wird von USB-Clienttreibern verwendet, um Daten an oder aus einer Steuerpipe zu übertragen.

Syntax

struct _URB_CONTROL_TRANSFER {
  struct _URB_HEADER   Hdr;
  USBD_PIPE_HANDLE     PipeHandle;
  ULONG                TransferFlags;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  UCHAR                SetupPacket[8];
};

Member

Hdr

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

PipeHandle

Handle für die Steuerpipe.

Wenn target der Standardendpunkt für die Steuerung ist, muss PipeHandleNULL sein. In diesem Fall müssen die TransferFlags das flag USBD_DEFAULT_PIPE_TRANSFER enthalten.

Wenn target ein nicht standardmäßiger Steuerelementendpunkt ist, gibt PipeHandle ein undurchsichtiges Handle für die Steuerelementpipe an. Der Hostcontrollertreiber gibt dieses Handle zurück, wenn der Clienttreiber die Gerätekonfiguration mit einer URB vom Typ URB_FUNCTION_SELECT_CONFIGURATION auswählt oder wenn der Clienttreiber die Einstellungen für eine Schnittstelle mit einer URB vom Typ URB_FUNCTION_SELECT_INTERFACE ändert.

TransferFlags

Gibt null, eins oder eine Kombination der folgenden Flags an:

Wert	Bedeutung
USBD_TRANSFER_DIRECTION_IN	Ist so festgelegt, dass Daten von einem Gerät angefordert werden. Um Daten auf ein Gerät zu übertragen, muss dieses Flag eindeutig sein.
USBD_TRANSFER_DIRECTION_OUT	Ist so festgelegt, dass Daten auf ein Gerät übertragen werden. Das Festlegen dieses Flags entspricht dem Löschen des USBD_TRANSFER_DIRECTION_IN Flags.
USBD_SHORT_TRANSFER_OK	Ist so festgelegt, dass der Hostcontroller anweisen soll, keinen Fehler zurückzugeben, wenn er ein Paket vom Gerät empfängt, das kürzer als die maximale Paketgröße für den Endpunkt ist. Die maximale Paketgröße für den Endpunkt wird im bMaxPacketSize0-Member der USB_DEVICE_DESCRIPTOR-Struktur (Gerätedeskriptor) für den Standardsteuerelementendpunkt gemeldet. Für einen nicht standardmäßigen Steuerelementendpunkt wird die maximale Paketgröße im wMaxPacketSize-Member der USB_ENDPOINT_DESCRIPTOR-Struktur (Endpunktdeskriptor) festgelegt. Wenn der Hostcontroller ein Paket empfängt, dessen Länge kürzer als der wMaxPacketSize-Wert auf einem Steuerelementendpunkt ist, verhält sich das Verhalten abhängig vom Typ des Hostcontrollers wie folgt: Auf EHCI-Hostcontrollern fährt der Hostcontroller sofort mit der status Phase der Steuerungsübertragung fort. Die Übertragung wird erfolgreich abgeschlossen, unabhängig davon, ob USBD_SHORT_TRANSFER_OK festgelegt ist. Wenn auf UHCI- und OHCI-Hostcontrollern USBD_SHORT_TRANSFER_OK festgelegt ist, fährt der Hostcontroller mit der status-Phase fort. Wenn USBD_SHORT_TRANSFER_OK nicht festgelegt ist, verlässt der Hostcontroller die Daten- und status Phasen der Steuerungsübertragung, und die Übertragung wird mit einem Fehler abgeschlossen.
USBD_DEFAULT_PIPE_TRANSFER	Ist so festgelegt, dass der Hostcontroller eine Steuerungsübertragung über die Standard-Steuerelementpipe durchführt. Dadurch kann der Aufrufer Befehle an die Standard-Steuerelementpipe senden, ohne das Pipehandle explizit anzugeben.

TransferBufferLength

Gibt die Länge des in TransferBuffer angegebenen oder in TransferBufferMDL beschriebenen Puffers in Bytes an. 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 Inhalt dieses Puffers hängt vom Wert von TransferFlags ab. Wenn USBD_TRANSFER_DIRECTION_IN angegeben ist, enthält dieser Puffer Daten, die beim Zurückgeben vom Hostcontrollertreiber vom Gerät gelesen werden. Andernfalls enthält dieser Puffer vom Treiber bereitgestellte Daten für die Übertragung an das Gerät.

TransferBufferMDL

Zeiger auf eine MDL, die einen residenten Puffer beschreibt, oder null ist, wenn ein Puffer in TransferBuffer bereitgestellt wird. Der Inhalt des Puffers hängt vom Wert von TransferFlags ab. Wenn USBD_TRANSFER_DIRECTION_IN angegeben ist, enthält der beschriebene Puffer Daten, die vom Gerät gelesen werden, wenn er vom Hostcontrollertreiber zurückgegeben wird. Andernfalls enthält der Puffer vom Treiber bereitgestellte Daten für die Übertragung an das Gerät. Diese MDL muss aus einem nicht ausseitigen Pool zugeordnet werden.

UrbLink

Reserviert. Darf nicht verwendet werden.

hca

Reserviert. Darf nicht verwendet werden.

SetupPacket[8]

Gibt ein ÜBER USB definiertes Anforderungssetuppaket an. Das Format eines USB-Anforderungssetuppakets befindet sich in der USB-Core-Spezifikation.

Hinweise

Die URB_CONTROL_TRANSFER_EX-Struktur ist mit URB_CONTROL_TRANSFER identisch, mit der Ausnahme, dass sie einen Timeoutwert im Feld Timeout bereitstellt.

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