Funzione SetupDiSetSelectedDriverA (setupapi.h)

  • Articolo

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

Vedi anche

SetupDiGetSelectedDriver