Función GetDeviceDriverBaseNameA (psapi.h)

Recupera el nombre base del controlador de dispositivo especificado.

Sintaxis

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

Parámetros

[in] ImageBase

Dirección de carga del controlador del dispositivo. Este valor se puede recuperar mediante la función EnumDeviceDrivers.

lpFilename

TBD

[in] nSize

Tamaño del búfer de lpBaseName, en caracteres. Si el búfer no es lo suficientemente grande como para almacenar el nombre base más el carácter nulo de terminación, la cadena se trunca.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto especifica la longitud de la cadena copiada en el búfer, sin incluir ningún carácter nulo de terminación.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

A partir de Windows 7 y Windows Server 2008 R2, Psapi.h establece números de versión para las funciones PSAPI. El número de versión de PSAPI afecta al nombre usado para llamar a la función y a la biblioteca que debe cargar un programa.

Si PSAPI_VERSION es 2 o superior, esta función se define como K32GetDeviceDriverBaseName en Psapi.h y se exporta en Kernel32.lib y Kernel32.dll. Si PSAPI_VERSION es 1, esta función se define como GetDeviceDriverBaseName en Psapi.h y exportada en Psapi.lib y Psapi.dll como contenedor que llama a K32GetDeviceDriverBaseName.

Los programas que deben ejecutarse en versiones anteriores de Windows, así como Windows 7 y versiones posteriores siempre deben llamar a esta función como GetDeviceDriverBaseName. Para garantizar la resolución correcta de símbolos, agregue Psapi.lib a la macro TARGETLIBS y compile el programa con –DPSAPI_VERSION=1. Para usar la vinculación dinámica en tiempo de ejecución, cargue Psapi.dll.

Ejemplos

Para obtener un ejemplo, vea Enumerar todos los controladores de dispositivo en system.

Nota

El encabezado psapi.h define GetDeviceDriverBaseName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	psapi.h
biblioteca de	Kernel32.lib en Windows 7 y Windows Server 2008 R2; Psapi.lib (si PSAPI_VERSION=1) en Windows 7 y Windows Server 2008 R2; Psapi.lib en Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP
DLL de	Kernel32.dll en Windows 7 y Windows Server 2008 R2; Psapi.dll (si PSAPI_VERSION=1) en Windows 7 y Windows Server 2008 R2; Psapi.dll en Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP

Consulte también

de información del controlador de dispositivo de

enumDeviceDrivers

funciones de PSAPI de