Función SetupDiSetClassInstallParamsW (setupapi.h)

  • Artículo

La función SetupDiSetClassInstallParams establece o borra los parámetros de instalación de clase para un conjunto de información del dispositivo o un elemento de información de dispositivo determinado.

Sintaxis

WINSETUPAPI BOOL SetupDiSetClassInstallParamsW(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]           DWORD                   ClassInstallParamsSize
);

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 clase.

[in, optional] DeviceInfoData

Puntero a una estructura SP_DEVINFO_DATA que representa el dispositivo para el que se van a establecer parámetros de instalación de clase. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiSetClassInstallParams establece los parámetros de instalación de clase para el dispositivo especificado. Si este parámetro es NULL, SetupDiSetClassInstallParams establece los parámetros de instalación de clase asociados a DeviceInfoSet.

[in, optional] ClassInstallParams

Puntero a un búfer que contiene los nuevos parámetros de instalación de clase que se van a usar. La estructura SP_CLASSINSTALL_HEADER al principio de este búfer debe tener su campo cbSize establecido en sizeof(SP_CLASSINSTALL_HEADER) y el campo InstallFunction debe establecerse en el código DI_FUNCTION que refleja el tipo de parámetros contenidos en el resto del búfer.

Si no se especifica ClassInstallParams , los parámetros de instalación de clase actuales, si los hay, se borran para el conjunto o elemento de información del dispositivo especificado.

[in] ClassInstallParamsSize

Tamaño, en bytes, del búfer ClassInstallParams . Si no se proporciona el búfer (es decir, se borran los parámetros de instalación de clase), ClassInstallParamsSize debe ser 0.

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.

Un efecto secundario de establecer parámetros de instalación de clase es que se establece la marca DI_CLASSINSTALLPARAMS. Si el autor de la llamada quiere establecer los parámetros, pero deshabilita su uso, esta marca debe borrarse mediante una llamada a SetupDiSetDeviceInstallParams.

Si se borran los parámetros de instalación de clase, se restablece la marca DI_CLASSINSTALLPARAMS.

Nota

El encabezado setupapi.h define SetupDiSetClassInstallParams 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
Conjunto de API ext-ms-win-setupapi-classinstallers-l1-1-0 (introducido en Windows 8)

Consulte también

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams