struttura _URB_CONTROL_FEATURE_REQUEST (usb.h)

La struttura _URB_CONTROL_FEATURE_REQUEST viene usata dai driver client USB per impostare o cancellare le funzionalità in un dispositivo, un'interfaccia o un endpoint.

Sintassi

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

Members

Hdr

Puntatore a una struttura di _URB_HEADER che specifica le informazioni sull'intestazione HEADER. Hdr.Function indica un set o un'operazione di funzionalità chiara da eseguire su un dispositivo, un'interfaccia, un endpoint o un altro componente non standard. Hdr.Function deve avere uno dei valori seguenti:

Hdr.Length deve essere uguale a sizeof(_URB_CONTROL_FEATURE_REQUEST).

Reserved

Riservato. Non usare.

Reserved2

Riservato. Non usare.

Reserved3

Riservato. Non usare.

Reserved4

Riservato. Non usare.

Reserved5

Riservato. Non usare.

UrbLink

Riservato. Non usare.

hca

Riservato. Non usare.

Reserved0

Riservato. Non usare.

FeatureSelector

Specifica il codice di funzionalità definito tramite USB da cancellare o impostare. L'uso di un codice di funzionalità non valido, non può essere impostato o non può essere cancellato causerà il blocco della destinazione. Il driver del bus copia il valore nel membro FeatureSelector nel campo wValue del pacchetto di installazione.

Index

Specifica l'indice definito dal dispositivo, restituito da una richiesta di configurazione riuscita, se la richiesta riguarda un endpoint o un'interfaccia. In caso contrario, Index deve essere zero. Il driver del bus copia il valore nel membro Index nel campo wIndex del pacchetto di installazione.

Reserved1

Riservato. Non usare.

Commenti

I driver possono usare la routine del servizio UsbBuildFeatureRequest per formattare questo FILE.

I membri riservati di questa struttura devono essere considerati opachi e sono riservati per l'uso del sistema.

Quando un driver esegue il braccio di un dispositivo USB per la riattivazione remota con una richiesta di IRP_MN_WAIT_WAKE, il driver del bus USB imposta automaticamente la funzionalità di riattivazione remota nel dispositivo. Una funzionalità di controllo NON è necessaria.

Analogamente, quando un conducente rilascia un oggetto WCF con un tipo di funzione di URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL a una pipe, il conducente del bus cancella automaticamente la funzionalità di stallo dell'endpoint della pipe. Il driver non deve inviare una funzionalità di controllo ODBC alla pipe per cancellare lo stallo dell'endpoint.

Requisiti

Requisito	Valore
Intestazione	usb.h (include Usb.h)

Vedi anche

URB

Strutture USB

_URB_HEADER