GetDeviceDriverBaseNameA, fonction (psapi.h)
Récupère le nom de base du pilote de périphérique spécifié.
Syntaxe
DWORD GetDeviceDriverBaseNameA(
[in] LPVOID ImageBase,
LPSTR lpFilename,
[in] DWORD nSize
);
Paramètres
[in] ImageBase
Adresse de chargement du pilote de périphérique. Cette valeur peut être récupérée à l’aide de la fonction EnumDeviceDrivers.
lpFilename
TBD
[in] nSize
Taille de la mémoire tampon lpBaseName, en caractères. Si la mémoire tampon n’est pas suffisamment grande pour stocker le nom de base et le caractère null de fin, la chaîne est tronquée.
Valeur de retour
Si la fonction réussit, la valeur de retour spécifie la longueur de la chaîne copiée dans la mémoire tampon, sans inclure de caractère null de fin.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
À compter de Windows 7 et Windows Server 2008 R2, Psapi.h établit des numéros de version pour les fonctions PSAPI. Le numéro de version PSAPI affecte le nom utilisé pour appeler la fonction et la bibliothèque qu’un programme doit charger.
Si PSAPI_VERSION est égal à 2, cette fonction est définie comme K32GetDeviceDriverBaseName dans Psapi.h et exportée dans Kernel32.lib et Kernel32.dll. Si PSAPI_VERSION est 1, cette fonction est définie comme GetDeviceDriverBaseName dans Psapi.h et exportée dans Psapi.lib et Psapi.dll en tant que wrapper qui appelle K32GetDeviceDriverBaseName.
Les programmes qui doivent s’exécuter sur des versions antérieures de Windows, ainsi que Windows 7 et versions ultérieures doivent toujours appeler cette fonction en tant que GetDeviceDriverBaseName. Pour garantir la résolution correcte des symboles, ajoutez Psapi.lib à la macro TARGETLIBS et compilez le programme avec –DPSAPI_VERSION=1. Pour utiliser la liaison dynamique au moment de l’exécution, chargez Psapi.dll.
Exemples
Pour obtenir un exemple, consultez énumération de tous les pilotes de périphérique dans le système.
Note
L’en-tête psapi.h définit GetDeviceDriverBaseName comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | psapi.h |
| bibliothèque | Kernel32.lib sur Windows 7 et Windows Server 2008 R2 ; Psapi.lib (si PSAPI_VERSION=1) sur Windows 7 et Windows Server 2008 R2 ; Psapi.lib sur Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP |
| DLL | Kernel32.dll sur Windows 7 et Windows Server 2008 R2 ; Psapi.dll (si PSAPI_VERSION=1) sur Windows 7 et Windows Server 2008 R2 ; Psapi.dll sur Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP |