Función SetupDiSetDeviceInstallParamsA (setupapi.h)

La función SetupDiSetDeviceInstallParams establece parámetros de instalación de dispositivos para un conjunto de información del dispositivo o un elemento de información de dispositivo determinado.

Sintaxis

WINSETUPAPI BOOL SetupDiSetDeviceInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in]           PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo para el que se van a establecer parámetros de instalación de dispositivos.

[in, optional] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica un elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y se puede establecer en NULL. Si se especifica este parámetro, SetupDiSetDeviceInstallParams establece los parámetros de instalación para el dispositivo especificado. Si este parámetro es NULL, SetupDiSetDeviceInstallParams establece los parámetros de instalación asociados a la lista global de controladores de clase para DeviceInfoSet.

[in] DeviceInstallParams

Puntero a una estructura de SP_DEVINSTALL_PARAMS que contiene los nuevos valores de los parámetros. DeviceInstallParams.cbSize debe establecerse en el tamaño, en bytes, de la estructura antes de llamar a esta función.

Valor devuelto

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

Comentarios

Todos los parámetros se validan antes de que se realicen cambios. Por lo tanto, un valor devuelto de FALSE indica que no se modificaron parámetros.

Nota

El encabezado setupapi.h define SetupDiSetDeviceInstallParams 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

SetupDiGetDeviceInstallParams