Partager via


Méthode GetDescriptor de la classe CIM_USBDevice (gestion Hyper-V)

Retourne le descripteur USBDevice tel que spécifié par les paramètres d’entrée.

Syntaxe

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

Paramètres

RequestType [in]

Bit-map qui identifie le type de demande de descripteur et le destinataire. Le type de demande peut être « standard », « class » ou « spécifique au fournisseur ». Le destinataire peut être « device », « interface », « endpoint » ou « other ». 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 l’octet faible. Pour plus d’informations, reportez-vous à la spécification USB.

RequestIndex [in]

Définit le code d’ID de langage de 2 octets utilisé par USBDevice lors du retour de données de descripteur de chaîne. Le paramètre est généralement 0 pour les descripteurs autres que des chaînes. Pour plus d’informations, reportez-vous à la spécification USB.

RequestLength [in, out]

En entrée, contient la 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. En sortie, ce paramètre correspond à 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 du paramètre n’est pas défini.

Valeur retournée

Retourne un 0 en cas de réussite ; sinon, retourne une erreur.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8.1
Serveur minimal pris en charge
Windows Server 2012 R2
Espace de noms
Racine\virtualisation\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Voir aussi

CIM_USBDevice