Función SetupDiSelectBestCompatDrv (setupapi.h)

La función SetupDiSelectBestCompatDrv es el controlador predeterminado para la solicitud de instalación de DIF_SELECTBESTCOMPATDRV .

Sintaxis

WINSETUPAPI BOOL SetupDiSelectBestCompatDrv(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Parámetros

[in] DeviceInfoSet

Identificador de un conjunto de información de dispositivo que contiene un elemento de información del dispositivo que representa el dispositivo para el que se va a seleccionar el mejor controlador compatible.

[in, out] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet. SetupDiSelectBestCompatDrv selecciona el mejor controlador para un elemento de información del dispositivo de la lista de controladores compatibles para el dispositivo especificado.

Valor devuelto

Si la operación se realiza correctamente, SetupDiSelectBestCompatDrv devuelve TRUE. De lo contrario, la función devuelve FALSE y el error registrado se puede recuperar mediante una llamada a GetLastError.

Comentarios

Si el autor de la llamada de SetupDiSelectBestCompatDrv es miembro del grupo Administradores y la clase del dispositivo es diferente que la clase del controlador seleccionado, SetupDiSelectBestCompatDrv establece la clase del dispositivo en la clase del controlador. Si no se desea este comportamiento, llame a esta función en un nivel de privilegio inferior.

Nota Solo un instalador de clase debe llamar a SetupDiSelectBestCompatDrv y solo en aquellas situaciones en las que el instalador de clase debe realizar operaciones de selección de controladores después de que SetupDiSelectBestCompatDrv complete la operación de selección de controladores predeterminada. En tales situaciones, el instalador de clase debe llamar directamente a SetupDiSelectBestCompatDrv cuando el instalador procesa una solicitud de DIF_SELECTBESTCOMPATDRV. Para obtener más información sobre cómo llamar al controlador predeterminado, vea Llamar a controladores de código DIF predeterminados.

 

SetupDiSelectBestCompatDrv está diseñado principalmente para seleccionar el mejor controlador compatible para un elemento de información del dispositivo en un equipo local. Aunque SetupDiSelectBestCompatDrv no producirá un error si el conjunto de información del dispositivo es para un equipo remoto, el resultado es de uso limitado porque el conjunto de información del dispositivo no se puede usar posteriormente como entrada con solicitudes de instalación DIF_Xxx o funciones SetupDiXxx que no admiten operaciones para un equipo remoto. En concreto, el conjunto de información del dispositivo no se puede usar posteriormente como entrada con una solicitud de instalación de DIF_INSTALLDEVICE para instalar un dispositivo en un equipo remoto.

Para obtener información sobre cómo se selecciona el mejor controlador, vea Cómo selecciona Windows Controladores.

Para obtener el controlador seleccionado para un dispositivo, llame a SetupDiGetSelectedDriver.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	setupapi.h (incluya Setupapi.h)
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Consulte también

DIF_SELECTBESTCOMPATDRV

SP_DEVINFO_DATA