Funzione SetupDiSetSelectedDriverA (setupapi.h)
La funzione SetupDiSetSelectedDriver imposta o reimposta il driver selezionato per un elemento informazioni del dispositivo o il driver di classe selezionato per un set di informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData,
[in, out] PSP_DRVINFO_DATA_A DriverInfoData
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo che contiene l'elenco dei driver da cui selezionare un driver per un elemento informazioni sul dispositivo o per il set di informazioni sul dispositivo.
[in, out] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro è specificato, SetupDiSetSelectedDriver imposta o reimposta il driver selezionato per il dispositivo specificato. Se questo parametro è NULL, SetupDiSetSelectedDriver imposta o reimposta il driver di classe selezionato per DeviceInfoSet.
[in, out] DriverInfoData
Puntatore a una struttura SP_DRVINFO_DATA che specifica il driver da selezionare. Questo parametro è facoltativo e può essere NULL. Se questo parametro e DeviceInfoData vengono forniti, il driver specificato deve essere membro di un elenco di driver associato a DeviceInfoData. Se questo parametro è specificato e DeviceInfoData è NULL, il driver deve essere membro dell'elenco di driver di classe globale per DeviceInfoSet. Se questo parametro è NULL, il driver selezionato viene reimpostato per l'elemento informazioni del dispositivo, se DeviceInfoData è specificato o il set di informazioni sul dispositivo, se DeviceInfoData è NULL.
Se DriverInfoData.Riservato è NULL, il chiamante richiede una ricerca di un nodo driver con i parametri specificati (DriverType, Description e ProviderName). Se viene trovata una corrispondenza, viene selezionato il nodo driver. Il campo Riservato viene aggiornato sull'output per riflettere il nodo driver effettivo in cui è stata trovata la corrispondenza. Se non viene trovata una corrispondenza, la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_INVALID_PARAMETER.
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Se il chiamante di SetupDiSetSelectedDriver è membro del gruppo Administrators, la classe del dispositivo è impostata sulla classe del driver selezionato, purché le due classi siano diverse.
Se DriverInfoData è NULL, SetupDiSetSelectedDriver reimposta il driver selezionato. Di conseguenza, non esiste alcun driver selezionato.
Nota
L'intestazione setupapi.h definisce SetupDiSetSelectedDriver come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |