Función SetupDiGetSelectedDriverA (setupapi.h)

La función setupDiGetSelectedDriver recupera el controlador seleccionado para un conjunto de información de dispositivo o un elemento de información de dispositivo determinado.

Sintaxis

WINSETUPAPI BOOL SetupDiGetSelectedDriverA(
  [in]           HDEVINFO           DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA   DeviceInfoData,
  [out]          PSP_DRVINFO_DATA_A DriverInfoData
);

Parámetros

[in] DeviceInfoSet

Identificador de la conjunto de información del dispositivo para el que se va a recuperar un controlador seleccionado.

[in, optional] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica un elemento de información del dispositivo que representa el dispositivo en DeviceInfoSet para el que se va a recuperar el controlador seleccionado. Este parámetro es opcional y se puede NULL. Si se especifica este parámetro, SetupDiGetSelectedDriver recupera el controlador seleccionado para el dispositivo especificado. Si este parámetro es null, SetupDiGetSelectedDriver recupera el controlador de clase seleccionado en la lista de controladores de clase global que está asociado a DeviceInfoSet.

[out] DriverInfoData

Puntero a una estructura SP_DRVINFO_DATA que recibe información sobre el controlador seleccionado.

Valor devuelto

La función devuelve TRUE si se ejecuta correctamente. De lo contrario, devuelve false y el error registrado se puede recuperar con una llamada a GetLastError. Si no se ha seleccionado un controlador para la instancia de dispositivo especificada, se ERROR_NO_DRIVER_SELECTED el error registrado.

Observaciones

Nota

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

Consulte también

SetupDiSetSelectedDriver