GetDeviceDriverBaseNameA-Funktion (psapi.h)
Ruft den Basisnamen des angegebenen Gerätetreibers ab.
Syntax
DWORD GetDeviceDriverBaseNameA(
[in] LPVOID ImageBase,
LPSTR lpFilename,
[in] DWORD nSize
);
Parameter
[in] ImageBase
Die Ladeadresse des Gerätetreibers. Dieser Wert kann mit der Funktion EnumDeviceDrivers abgerufen werden.
lpFilename
TBD
[in] nSize
Die Größe des lpBaseName-Puffers in Zeichen. Wenn der Puffer nicht groß genug ist, um den Basisnamen und das abschließende NULL-Zeichen zu speichern, wird die Zeichenfolge abgeschnitten.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die Länge der Zeichenfolge an, die in den Puffer kopiert wurde, ohne ein abschließendes NULL-Zeichen.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Ab Windows 7 und Windows Server 2008 R2 richtet Psapi.h Versionsnummern für die PSAPI-Funktionen ein. Die PSAPI-Versionsnummer wirkt sich auf den Namen aus, der zum Aufrufen der Funktion und der Bibliothek verwendet wird, die ein Programm laden muss.
Wenn PSAPI_VERSION 2 oder höher ist, wird diese Funktion als K32GetDeviceDriverBaseName in Psapi.h definiert und in Kernel32.lib und Kernel32.dll exportiert. Wenn PSAPI_VERSION 1 ist, wird diese Funktion als GetDeviceDriverBaseName in Psapi.h definiert und in Psapi.lib exportiert und Psapi.dll als Wrapper, der K32GetDeviceDriverBaseName aufruft.
Programme, die unter früheren Versionen von Windows sowie windows 7 und höheren Versionen ausgeführt werden müssen, sollten diese Funktion immer als GetDeviceDriverBaseName aufrufen. Fügen Sie dem TARGETLIBS-Makro Psapi.lib hinzu, und kompilieren Sie das Programm mit –DPSAPI_VERSION=1, um die richtige Auflösung von Symbolen sicherzustellen. Laden Sie Psapi.dll, um dynamische Laufzeitverknüpfung zu verwenden.
Beispiele
Ein Beispiel finden Sie unter Auflisten aller Gerätetreiber im System.
Hinweis
Der psapi.h-Header definiert GetDeviceDriverBaseName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | psapi.h |
| Bibliothek | Kernel32.lib unter Windows 7 und Windows Server 2008 R2; Psapi.lib (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.lib unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP |
| DLL | Kernel32.dll unter Windows 7 und Windows Server 2008 R2; Psapi.dll (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.dll unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP |