Condividi tramite


Metodo GetDescriptor della classe CIM_USBDevice (gestione Hyper-V)

Restituisce il descrittore USBDevice come specificato dai parametri di input.

Sintassi

uint32 GetDescriptor(
  [in]      uint8  RequestType,
  [in]      uint16 RequestValue,
  [in]      uint16 RequestIndex,
  [in, out] uint16 RequestLength,
  [out]     uint8  Buffer[]
);

Parametri

RequestType [in]

Mappa bit che identifica il tipo di richiesta del descrittore e il destinatario. Il tipo di richiesta può essere "standard", "classe" o "specifico del fornitore". Il destinatario può essere "device", "interface", "endpoint" o "other". Fare riferimento alla specifica USB per i valori appropriati per ogni bit.

RequestValue [in]

Contiene il tipo descrittore nel byte elevato e nell'indice descrittore (ad esempio, indice o offset nella matrice descrittore) nel byte basso. Per altre informazioni, vedere la specifica USB.

RequestIndex [in]

Definisce il codice ID lingua a 2 byte usato da USBDevice durante la restituzione dei dati del descrittore di stringa. Il parametro è in genere 0 per i descrittori non stringa. Per altre informazioni, vedere la specifica USB.

RequestLength [in, out]

In input, contiene la lunghezza , espressa in ottetti, del descrittore che deve essere restituito. Se questo valore è minore della lunghezza effettiva del descrittore, verrà restituita solo la lunghezza richiesta. Se è maggiore della lunghezza effettiva, viene restituita la lunghezza effettiva. Nell'output questo parametro è la lunghezza, espressa in ottetti, del buffer restituito. Se il descrittore richiesto non esiste, il contenuto di questo parametro non è definito.

Buffer [out]

Restituisce le informazioni sul descrittore richiesto. Se il descrittore non esiste, il contenuto del parametro non è definito.

Valore restituito

Restituisce un valore 0 in caso di esito positivo; in caso contrario, restituisce un errore.

Requisiti

Requisito Valore
Client minimo supportato
Windows 8.1
Server minimo supportato
R2 per Windows Server 2012
Spazio dei nomi
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Vedi anche

CIM_USBDevice