Función SetupDiGetDeviceInstallParamsW (setupapi.h)

  • Artículo

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

Sintaxis

WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsW(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [out]          PSP_DEVINSTALL_PARAMS_W DeviceInstallParams
);

Parámetros

[in] DeviceInfoSet

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

[in, optional] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiGetDeviceInstallParams recupera los parámetros de instalación del dispositivo especificado. Si este parámetro es NULL, la función recupera los parámetros de instalación de dispositivos globales asociados a DeviceInfoSet.

[out] DeviceInstallParams

Puntero a una estructura de SP_DEVINSTALL_PARAMS que recibe los parámetros de instalación del dispositivo. 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 realizando una llamada a GetLastError.

Comentarios

Nota

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

   
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

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams