_URB_OS_FEATURE_DESCRIPTOR_REQUEST struttura (usb.h)

Articolo
03/05/2024

La struttura _URB_OS_FEATURE_DESCRIPTOR_REQUEST viene usata dal driver dell'hub USB per recuperare i descrittori delle funzionalità del sistema operativo Microsoft da un dispositivo USB o da un'interfaccia in un dispositivo USB.

Sintassi

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

Members

Hdr

Puntatore a una struttura _URB_HEADER che specifica le informazioni sull'intestazione DELL'AREA. Hdr.Function deve URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR. Hdr.Length deve essere sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST).

Reserved

Reserved0

TransferBufferLength

Specifica la lunghezza, in byte, del buffer specificato in TransferBuffer o descritto in TransferBufferMDL. Il driver del controller host restituisce il numero di byte letti in questo membro. L'implementazione corrente di questa funzione limita le dimensioni massime del descrittore di funzionalità del sistema operativo MS a 4 Kilobyte.

TransferBuffer

Puntatore a un buffer residente per il trasferimento o null se viene fornito un MDL in TransferBufferMDL.

TransferBufferMDL

Puntatore a un MDL che descrive un buffer residente o è NULL se viene fornito un buffer in TransferBuffer. Questa MDL deve essere allocata dal pool non a pagina.

UrbLink

Riservato. Non usare.

hca

Recipient

Specifica se il destinatario è il dispositivo USB o un'interfaccia sul dispositivo USB. È necessario specificare uno dei valori seguenti:

0 indica che il dispositivo USB è il destinatario della richiesta.
1 indica che un'interfaccia USB è il destinatario della richiesta.
2 indica che un endpoint USB è il destinatario della richiesta.

Reserved1

Reserved2

InterfaceNumber

Indica il numero di interfaccia che è il destinatario della richiesta, se il valore membro destinatario è 1. Deve essere impostato su 0 se il dispositivo USB è il destinatario.

MS_PageIndex

Deve essere 0. Indice di pagina della pagina 64K del descrittore di funzionalità del sistema operativo MS da restituire. L'implementazione corrente supporta solo una dimensione massima del descrittore pari a 4K.

MS_FeatureDescriptorIndex

Indice per il descrittore di funzionalità del sistema operativo MS da richiedere.

Reserved3

Commenti

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

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP e nei sistemi operativi successivi.
Intestazione	usb.h (include Usb.h)

Vedi anche

URB

_URB_HEADER

Condividi tramite