Funzione GetDeviceDriverBaseNameA (psapi.h)

Articolo
11/20/2024

Recupera il nome di base del driver di dispositivo specificato.

Sintassi

DWORD GetDeviceDriverBaseNameA(
  [in] LPVOID ImageBase,
       LPSTR  lpFilename,
  [in] DWORD  nSize
);

Parametri

[in] ImageBase

Indirizzo di caricamento del driver di dispositivo. Questo valore può essere recuperato usando la funzione EnumDeviceDrivers.

lpFilename

TBD

[in] nSize

Dimensioni del buffer di lpBaseName, in caratteri. Se il buffer non è sufficientemente grande da archiviare il nome di base più il carattere Null di terminazione, la stringa viene troncata.

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica la lunghezza della stringa copiata nel buffer, senza includere alcun carattere null di terminazione.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

A partire da Windows 7 e Windows Server 2008 R2, Psapi.h stabilisce i numeri di versione per le funzioni PSAPI. Il numero di versione PSAPI influisce sul nome usato per chiamare la funzione e la libreria che un programma deve caricare.

Se PSAPI_VERSION è 2 o versione successiva, questa funzione viene definita come K32GetDeviceDriverBaseName in Psapi.h ed esportata in Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION è 1, questa funzione viene definita come GetDeviceDriverBaseName in Psapi.h ed esportata in Psapi.lib e Psapi.dll come wrapper che chiama K32GetDeviceDriverBaseName.

I programmi che devono essere eseguiti in versioni precedenti di Windows e Windows 7 e versioni successive devono sempre chiamare questa funzione come GetDeviceDriverBaseName. Per garantire la risoluzione corretta dei simboli, aggiungere Psapi.lib alla macro TARGETLIBS e compilare il programma con –DPSAPI_VERSION=1. Per usare il collegamento dinamico in fase di esecuzione, caricare Psapi.dll.

Esempi

Per un esempio, vedere Enumerating all Device Drivers in the System.

Nota

L'intestazione psapi.h definisce GetDeviceDriverBaseName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	psapi.h
libreria	Kernel32.lib in Windows 7 e Windows Server 2008 R2; Psapi.lib (se PSAPI_VERSION=1) in Windows 7 e Windows Server 2008 R2; Psapi.lib in Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP
dll	Kernel32.dll in Windows 7 e Windows Server 2008 R2; Psapi.dll (se PSAPI_VERSION=1) in Windows 7 e Windows Server 2008 R2; Psapi.dll in Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP

Vedere anche

informazioni sul driver di dispositivo

EnumDeviceDrivers

funzioni PSAPI

Condividi tramite