IWDFUsbTargetDevice ::RetrieveDeviceInformation, méthode (wudfusb.h)

Article
02/07/2025

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

La méthode RetrieveDeviceInformation récupère les informations d’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, en entrée, contient la taille, en octets, de la mémoire tampon qui RetrieveDeviceInformation fournit dans tampon. En sortie, ce paramètre contient la taille requise RetrieveDeviceInformation pour tampon.

[out] Buffer

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

Valeur de retour

RetrieveDeviceInformation retourne l’une des valeurs suivantes :

Retourner le code	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), lors d’un retour réussi, tampon indique la vitesse d’exploitation de l’appareil. 0x03 indique une vitesse élevée ou supérieure ; 0x01 indique une vitesse totale ou inférieure.

La méthode RetrieveDeviceInformation génère une requête UMDF et envoie de manière 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.

Exigences

Exigence	Valeur
fin du support	Indisponible dans UMDF 2.0 et versions ultérieures.
plateforme cible	Bureau
version minimale de UMDF	1.5
d’en-tête	wudfusb.h (include Wudfusb.h)
DLL	WUDFx.dll

Voir aussi

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation

Partager via