Funzione SetupDiSetSelectedDriverA (setupapi.h)

Il SetupDiSetSelectedDriver set di funzioni o reimposta, il driver selezionato per un elemento informazioni sul 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 di 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 di SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiSetSelectedDriver set o reimposta, il driver selezionato per il dispositivo specificato. Se questo parametro è NULL, set di SetupDiSetSelectedDriver 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 vengono forniti DeviceInfoData, il driver specificato deve essere un membro di un elenco di driver associato a DeviceInfoData. Se questo parametro viene 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 sul dispositivo, se viene specificato DeviceInfoData 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, Descriptione ProviderName). Se viene trovata una corrispondenza, viene selezionato il nodo del driver. Il campo riservato viene aggiornato nell'output in modo da 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

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

Osservazioni

Se il chiamante di SetupDiSetSelectedDriver è membro del gruppo Administrators, la classe del dispositivo viene impostata sulla classe del driver selezionato, purché le due classi siano diverse.

Se DriverInfoData è NULL, SetupDiSetSelectedDriver reimposta il driver selezionato. Di conseguenza, non è presente alcun driver selezionato.

Fabbisogno

Vedere anche

SetupDiGetSelectedDriver