Función SetupDiGetDeviceInstallParamsA (setupapi.h)
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 SetupDiGetDeviceInstallParamsA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DEVINSTALL_PARAMS_A 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 se puede 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 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 ejecuta correctamente. De lo contrario, devuelve FALSE y se puede recuperar el error registrado realizando una llamada a GetLastError.
Observaciones
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 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |