Partager via

Méthode IWDFUsbTargetDevice ::RetrieveDeviceInformation (wudfusb.h)

  • Article

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode RetrieveDeviceInformation récupère les informations sur l’appareil du type spécifié.

Syntaxe

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

Paramètres

[in] InformationType

Type d’informations que le pilote UMDF demande sur l’appareil.

[in, out] BufferLength

Pointeur vers une variable qui, lors de l’entrée, contient la taille, en octets, de la mémoire tampon que RetrieveDeviceInformation fournit dans Buffer. Lors de la sortie, ce paramètre contient la taille requise par RetrieveDeviceInformation pour Buffer.

[out] Buffer

Pointeur qui reçoit la mémoire tampon qui contient les informations de l’appareil.

Valeur retournée

RetrieveDeviceInformation retourne l’une des valeurs suivantes :

Code de retour Description
S_OK

RetrieveDeviceInformation a correctement récupéré les informations de l’appareil.
E_OUTOFMEMORY

RetrieveDeviceInformation a rencontré un échec d’allocation.
Code d’erreur défini dans Winerror.h
 Cette valeur correspond au code d’erreur retourné par l’API WinUsb.

Remarques

Pour plus d’informations sur les types d’informations valides qu’un pilote UMDF peut passer pour le paramètre InformationType , consultez la fonction WinUsb_QueryDeviceInformation .

Si InformationType est DEVICE_SPEED (0x01), en cas de retour réussi, Buffer indique la vitesse de fonctionnement de l’appareil. 0x03 indique une vitesse élevée ou supérieure ; 0x01 indique une vitesse maximale ou une vitesse inférieure.

La méthode RetrieveDeviceInformation génère une requête UMDF et envoie de façon synchrone la requête à la cible d’E/S.

Exemples

Pour obtenir un exemple de code montrant comment utiliser la méthodeRetrieveDeviceInformation , consultez IWDFUsbTargetPipe ::SetPipePolicy.

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1.5
En-tête wudfusb.h (inclure Wudfusb.h)
DLL WUDFx.dll

Voir aussi

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation