Funzione SetupDiSelectBestCompatDrv (setupapi.h)

La funzione SetupDiSelectBestCompatDrv è il gestore predefinito per la richiesta di installazione DIF_SELECTBESTCOMPATDRV .

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per un set di informazioni sul dispositivo che contiene un elemento informazioni sul dispositivo che rappresenta il dispositivo per il quale selezionare il driver compatibile migliore.

[in, out] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. SetupDiSelectBestCompatDrv seleziona il driver migliore per un elemento informazioni sul dispositivo dall'elenco dei driver compatibili per il dispositivo specificato.

Valore restituito

Se l'operazione ha esito positivo, SetupDiSelectBestCompatDrv restituisce TRUE. In caso contrario, la funzione restituisce FALSE e l'errore registrato può essere recuperato da una chiamata a GetLastError.

Commenti

Se il chiamante di SetupDiSelectBestCompatDrv è membro del gruppo Administrators e la classe del dispositivo è diversa dal fatto che la classe del driver selezionato, SetupDiSelectBestCompatDrv imposta la classe del dispositivo sulla classe del driver. Se questo comportamento non è desiderato, chiamare questa funzione a un livello di privilegi inferiore.

Nota Solo un programma di installazione di classe deve chiamare SetupDiSelectBestCompatDrv e solo in quelle situazioni in cui il programma di installazione della classe deve eseguire operazioni di selezione del driver dopo che SetupDiSelectBestCompatDrv completa l'operazione di selezione del driver predefinita. In tali situazioni, il programma di installazione della classe deve chiamare direttamente SetupDiSelectBestCompatDrv quando il programma di installazione elabora una richiesta di DIF_SELECTBESTCOMPATDRV. Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.

 

SetupDiSelectBestCompatDrv è progettato principalmente per selezionare il driver compatibile migliore per un elemento informazioni sul dispositivo in un computer locale. Anche se SetupDiSelectBestCompatDrv non riuscirà se il set di informazioni sul dispositivo è per un computer remoto, il risultato è limitato perché il set di informazioni sul dispositivo non può essere usato successivamente come input con richieste di installazione DIF_Xxx o funzioni SetupDiXxx che non supportano le operazioni per un computer remoto. In particolare, il set di informazioni sul dispositivo non può essere usato successivamente come input con una richiesta di installazione di DIF_INSTALLDEVICE per installare un dispositivo in un computer remoto.

Per informazioni su come viene selezionato il driver migliore, vedere Modalità di selezione dei driver di Windows.

Per ottenere il driver selezionato per un dispositivo, chiamare SetupDiGetSelectedDriver.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	setupapi.h (include Setupapi.h)
Libreria	Setupapi.lib
DLL	Setupapi.dll

Vedi anche

DIF_SELECTBESTCOMPATDRV

SP_DEVINFO_DATA