Función SetupDiGetClassInstallParamsW (setupapi.h)

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

Sintaxis

WINSETUPAPI BOOL SetupDiGetClassInstallParamsW(
  [in]            HDEVINFO                DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA        DeviceInfoData,
  [out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]            DWORD                   ClassInstallParamsSize,
  [out, optional] PDWORD                  RequiredSize
);

Parámetros

[in] DeviceInfoSet

Identificador de un conjunto de información de dispositivo que contiene los parámetros de instalación de clase que se van a recuperar.

[in, optional] DeviceInfoData

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

[out, optional] ClassInstallParams

Puntero a un búfer que contiene una estructura SP_CLASSINSTALL_HEADER . Esta estructura debe tener su miembro cbSize establecido en sizeof(SP_CLASSINSTALL_HEADER) en la entrada o el búfer se considera no válido. En la salida, el miembro InstallFunction se rellena con el código de la función de instalación del dispositivo para los parámetros de instalación de clase que se recuperan. Si el búfer es lo suficientemente grande, también recibe la estructura de parámetros de instalación de clase específica del código de función. Si no se especifica ClassInstallParams , ClassInstallParamsSize debe ser 0.

[in] ClassInstallParamsSize

Tamaño, en bytes, del búfer ClassInstallParams . Si se proporciona el búfer, debe ser al menos tan grande como sizeof(SP_CLASSINSTALL_HEADER). Si no se proporciona el búfer, ClassInstallParamsSize debe ser 0.

[out, optional] RequiredSize

Puntero a una variable de tipo DWORD que recibe el número de bytes necesarios para almacenar los parámetros de instalación de clase. Este parámetro es opcional y puede ser NULL.

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

Los parámetros de instalación de clase son específicos de un código de función de instalación de dispositivo determinado que se almacena en el campo ClassInstallHeader ubicado al principio del búfer ClassInstallParams .

Nota

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

SetupDiSetClassInstallParams