Freigeben über


_URB_CONTROL_FEATURE_REQUEST Struktur (usb.h)

Die _URB_CONTROL_FEATURE_REQUEST Struktur wird von USB-Clienttreibern verwendet, um Features auf einem Gerät, einer Schnittstelle oder einem Endpunkt festzulegen oder zu löschen.

Syntax

struct _URB_CONTROL_FEATURE_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved2;
  ULONG                Reserved3;
  PVOID                Reserved4;
  PMDL                 Reserved5;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  USHORT               Reserved0;
  USHORT               FeatureSelector;
  USHORT               Index;
  USHORT               Reserved1;
};

Angehörige

Hdr

Zeigen Sie auf eine _URB_HEADER Struktur, die die URB-Headerinformationen angibt. Hdr.Function gibt entweder einen Satz oder einen eindeutigen Funktionsvorgang an, der auf einem Gerät, einer Schnittstelle, einem Endpunkt oder einer anderen nicht standardmäßigen Komponente ausgeführt werden soll. Hdr.Function- muss einen der folgenden Werte aufweisen:

Hdr.Length- muss sizeof(_URB_CONTROL_FEATURE_REQUEST)entsprechen.

Reserved

Reserviert. Nicht verwenden.

Reserved2

Reserviert. Nicht verwenden.

Reserved3

Reserviert. Nicht verwenden.

Reserved4

Reserviert. Nicht verwenden.

Reserved5

Reserviert. Nicht verwenden.

UrbLink

Reserviert. Nicht verwenden.

hca

Reserviert. Nicht verwenden.

Reserved0

Reserviert. Nicht verwenden.

FeatureSelector

Gibt den USB-definierten Featurecode an, der gelöscht oder festgelegt werden soll. Die Verwendung eines ungültigen Featurecodes kann nicht festgelegt werden oder kann nicht gelöscht werden, führt dazu, dass das Ziel angehalten wird. Der Bustreiber kopiert den Wert im FeatureSelector Member in das wValue Feld des Setuppakets.

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 ist. Andernfalls muss Index- null sein. Der Bustreiber kopiert den Wert im Index Member in das wIndex Feld des Setuppakets.

Reserved1

Reserviert. Nicht verwenden.

Bemerkungen

Treiber können die UsbBuildFeatureRequest 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.

Wenn ein Treiber ein USB-Gerät für die Remotereaktivierung mit einer IRP_MN_WAIT_WAKE Anforderung einschränkt, legt der USB-Bustreiber automatisch die Remote-Wakeup-Funktion auf dem Gerät fest. Eine Steuerelementfunktions-URB ist nicht erforderlich.

Wenn ein Fahrer eine URB mit einem Funktionstyp von URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL an eine Rohrleitung ausgibt, löscht der Bustreiber automatisch die Endpunkt-Stallfunktion der Pfeife. Der Treiber muss keine Steuerelementfunktions-URB an die Pipe senden, um den Endpunktstand zu löschen.

Anforderungen

Anforderung Wert
Header- usb.h (include Usb.h)

Siehe auch

URB-

USB-Strukturen

_URB_HEADER