Méthode GetDescriptor de la _ classe Usbhub CIM

La méthode GetDescriptor retourne le descripteur de concentrateur USB comme spécifié par les paramètres d’entrée.

Important

Les classes de la DMTF (Distributed Management Task Force) CIM (Common Information Model) sont les classes parentes sur lesquelles les classes WMI sont générées. WMI ne prend actuellement en charge que les schémas de version CIM 2. x.

Cette rubrique utilise la syntaxe format MOF (MOF). Pour plus d’informations sur l’utilisation de cette méthode, consultez appel d’une méthode.

Syntaxe

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

Paramètres

RequestType [ dans]

Identificateur mappé en bits pour le type de demande de descripteur et le destinataire. Pour obtenir les valeurs appropriées pour chaque bit, consultez la spécification USB.

RequestValue [ dans]

Contient le type de descripteur dans l’octet de poids fort et l’index de descripteur (par exemple, index ou offset dans le tableau de descripteurs) dans l’octet de poids faible. Pour plus d’informations, consultez la spécification USB.

RequestIndex [ dans]

Spécifie le code de l’identificateur de langue à 2 octets utilisé par le périphérique USB lors du retour de données de descripteur de chaîne. Le paramètre est généralement 0 (zéro) pour les descripteurs de non-chaîne. Pour plus d’informations, consultez la spécification USB.

RequestLength [ in, out]

En entrée, longueur (en octets) du descripteur qui doit être retourné. Si cette valeur est inférieure à la longueur réelle du descripteur, seule la longueur demandée est retournée. Si elle est supérieure à la longueur réelle, la longueur réelle est retournée.

Sur la sortie, la longueur (en octets) de la mémoire tampon retournée. Si le descripteur demandé n’existe pas, le contenu de ce paramètre n’est pas défini.

Mémoire tampon [ à]

La mémoire tampon retourne les informations de descripteur demandées. Si le descripteur n’existe pas, le contenu de la mémoire tampon n’est pas défini.

Valeur retournée

Retourne la valeur 0 (zéro) si le descripteur USB est retourné avec succès, 1 (un) si la demande n’est pas prise en charge, et tout autre nombre pour indiquer une erreur. Dans une sous-classe, l’ensemble de codes de retour possibles peut être spécifié à l’aide d’un qualificateur ValueMap sur la méthode. Les chaînes dans lesquelles le contenu mofqualifier est traduit peuvent également être spécifiées dans la sous-classe en tant que qualificateur de tableau de valeurs .

Remarques

Actuellement, cette méthode n’est pas implémentée par WMI. Pour utiliser cette méthode, vous devez l’implémenter dans votre propre fournisseur.

Cette documentation est dérivée des descriptions de classe CIM publiées par le DMTF. Microsoft peut avoir apporté des modifications pour corriger les erreurs mineures, se conformer aux normes de documentation du kit de développement logiciel (SDK) Microsoft ou fournir plus d’informations.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
En-tête
Wmcodecdsp. h
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

_Usbhub CIM

_Usbhub CIM