Metodo GetDescriptor della classe CIM_USBHub

Articolo
06/12/2023

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	Wmcodecdsp.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

CIM_USBHub
CIM_USBHub

Condividi tramite