Partager via

IWDFDriver ::RetrieveVersionString, méthode (wudfddi.h)

  • Article

[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 RetrieveVersionString récupère la version de l’infrastructure.

Syntaxe

HRESULT RetrieveVersionString(
  [out]     PWSTR pVersion,
  [in, out] DWORD *pdwVersionLength
);

Paramètres

[out] pVersion

Pointeur vers une mémoire tampon qui reçoit une chaîne NULL-terminated qui représente la version de l’infrastructure si la mémoire tampon fournie n’est pas -NULL et RetrieveVersionString réussit.

[in, out] pdwVersionLength

Pointeur vers une variable qui reçoit la taille, en caractères, de la chaîne de version vers laquelle pVersion pointe. Lors de l’entrée, cette variable contient la taille, en octets, de la mémoire tampon à pVersion .

Si la mémoire tampon à pVersion est NULL, la valeur que le pilote fournit est égale à zéro. L’infrastructure retourne ensuite la taille, en caractères, requise pour la chaîne de version.

Si la mémoire tampon à pVersion n’est pasNULL, l’infrastructure retourne la taille, en caractères, de la chaîne de version.

Valeur de retour

RetrieveVersionString retourne S_OK pour les scénarios suivants :

  • La mémoire tampon à laquelle le paramètre pVersion pointe n’était pas NULL et suffisamment volumineux pour contenir la chaîne de version, y compris le caractère NULL. En outre, l’infrastructure a correctement copié la chaîne dans la mémoire tampon fournie et défini la variable pointée par le paramètre pdwVersionLength sur le nombre de caractères de la chaîne.
  • La mémoire tampon à pVersion a été NULL, le pilote a prédéfini la variable à pdwVersionLength sur 0, et l’infrastructure a défini la variable sur pdwVersionLength sur le nombre de caractères requis pour la chaîne.
RetrieveVersionString retourne HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) pour indiquer que la mémoire tampon fournie n’est pas NULL et ne contient pas suffisamment d’espace pour contenir la version. L’infrastructure définit la variable à pdwVersionLength le nombre de caractères requis pour la chaîne.

retrieveVersionString peut également retourner d’autres valeurs HRESULT.

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 wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll