Función SetupDiGetDriverInstallParamsA (setupapi.h)

  • Artículo

La función SetupDiGetDriverInstallParams recupera los parámetros de instalación del controlador para un conjunto de información del dispositivo o un elemento de información de dispositivo determinado.

Sintaxis

WINSETUPAPI BOOL SetupDiGetDriverInstallParamsA(
  [in]           HDEVINFO              DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA      DeviceInfoData,
  [in]           PSP_DRVINFO_DATA_A    DriverInfoData,
  [out]          PSP_DRVINSTALL_PARAMS DriverInstallParams
);

Parámetros

[in] DeviceInfoSet

Identificador de un conjunto de información de dispositivo que contiene un elemento de información del controlador que representa el controlador para el que se van a recuperar los parámetros de instalación.

[in, optional] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que contiene un elemento de información del dispositivo que representa el dispositivo para el que se van a recuperar los parámetros de instalación. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiGetDriverInstallParams recupera información sobre un controlador que es miembro de una lista de controladores para el dispositivo especificado. Si este parámetro es NULL, SetupDiGetDriverInstallParams recupera información sobre un controlador que es miembro de la lista global de controladores de clase para DeviceInfoSet.

[in] DriverInfoData

Puntero a una estructura de SP_DRVINFO_DATA que especifica el elemento de información del controlador que representa el controlador para el que se van a recuperar los parámetros de instalación. Si se proporciona DeviceInfoData , el controlador debe ser miembro de la lista de controladores del dispositivo especificado por DeviceInfoData. De lo contrario, el controlador debe ser miembro de la lista global de controladores de clase para DeviceInfoSet.

[out] DriverInstallParams

Puntero a una estructura de SP_DRVINSTALL_PARAMS para recibir los parámetros de instalación de este controlador.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar mediante una llamada a GetLastError.

Comentarios

Nota

El encabezado setupapi.h define SetupDiGetDriverInstallParams 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib

Consulte también

SetupDiSetDriverInstallParams