Méthode GetDescriptor de la classe CIM_USBDevice (Wmcodecdsp.h)

La méthode GetDescriptor retourne le descripteur de périphérique USB tel que spécifié par les paramètres d’entrée.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). 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 [in]

Identificateur mappé par bits pour le type de demande de descripteur et le destinataire. Reportez-vous à la spécification USB pour connaître les valeurs appropriées pour chaque bit.

RequestValue [in]

Contient le type de descripteur dans l’octet élevé et l’index de descripteur (par exemple, index ou décalage dans le tableau de descripteur) dans le bas octet. Pour plus d’informations, consultez la spécification USB.

RequestIndex [in]

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

RequestLength [in, out]

Lors de l’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.

Lors de 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 [out]

Retourne les informations de descripteur demandées. Si le descripteur n’existe pas, le contenu de ce paramètre n’est pas défini.

Valeur retournée

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

Notes

Cette méthode n’est actuellement 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 classes CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger des erreurs mineures, se conformer aux normes de documentation du SDK Microsoft ou fournir plus d’informations.

Spécifications

Voir aussi

CIM_USBDevice

CIM_USBDevice