Metodo GetDescriptor della classe CIM_USBHub
Il metodo GetDescriptor restituisce il descrittore dell'hub USB come specificato dai parametri di input.
Importante
Le classi CIM (Distributed Management Task Force) (Common Information Model) di DMTF (Distributed Management Task Force) sono le classi padre su cui vengono compilate le classi WMI. WMI supporta attualmente solo gli schemi di versione CIM 2.x.
Questo argomento usa la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 GetDescriptor(
[in] uint8 RequestType,
[in] uint16 RequestValue,
[in] uint16 RequestIndex,
[in, out] uint16 RequestLength,
[out] uint8 Buffer[]
);
Parametri
-
RequestType [in]
-
Identificatore mappato a bit per il tipo di richiesta del descrittore e il destinatario. Per i valori appropriati per ogni bit, vedere la specifica USB.
-
RequestValue [in]
-
Contiene il tipo descrittore nel byte elevato e nell'indice descrittore ,ad esempio indice o offset nella matrice del descrittore, nel byte basso. Per altre informazioni, vedere la specifica USB.
-
RequestIndex [in]
-
Specifica il codice identificatore del linguaggio a 2 byte usato dal dispositivo USB durante la restituzione dei dati del descrittore di stringa. Il parametro è in genere 0 (zero) per descrittori non stringa. Per altre informazioni, vedere la specifica USB.
-
RequestLength [in, out]
-
In input, la lunghezza (in ottetti) del descrittore che deve essere restituito. Se questo valore è minore della lunghezza effettiva del descrittore, viene restituita solo la lunghezza richiesta. Se è maggiore della lunghezza effettiva, viene restituita la lunghezza effettiva.
In output, la lunghezza (in ottetti) del buffer restituito. Se il descrittore richiesto non esiste, il contenuto di questo parametro non è definito.
-
Buffer [out]
-
Buffer restituisce le informazioni del descrittore richiesto. Se il descrittore non esiste, il contenuto del buffer non è definito.
Valore restituito
Restituisce un valore pari a 0 (zero) se il descrittore USB viene restituito correttamente, 1 (uno) se la richiesta non è supportata e qualsiasi altro numero per indicare un errore. In una sottoclasse, è possibile specificare il set di codici restituiti possibili usando un qualificatore ValueMap nel metodo . Le stringhe a cui è possibile tradurre il contenuto del mofqualifier possono essere specificate anche nella sottoclasse come qualificatore matrice Valori .
Commenti
Questo metodo non è attualmente implementato da WMI. Per usare questo metodo, è necessario implementarlo nel proprio provider.
Questa documentazione deriva dalle descrizioni della classe CIM pubblicate dal DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, conformi agli standard della documentazione di Microsoft SDK o fornire altre informazioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Radice\CIMV2 |
| Intestazione |
|
| MOF |
|
| DLL |
|