Funzione SetupDiSelectOEMDrv (setupapi.h)
La funzione SetupDiSelectOEMDrv seleziona un driver per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo che usa un percorso OEM fornito dall'utente.
Sintassi
WINSETUPAPI BOOL SetupDiSelectOEMDrv(
[in, optional] HWND hwndParent,
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
Parametri
[in, optional] hwndParent
Handle di finestra che sarà l'elemento padre di qualsiasi dialogo creato durante l'elaborazione di questa funzione. Questo parametro può essere usato per eseguire l'override del campo hwndParent nel blocco dei parametri di installazione del set o dell'elemento informazioni del dispositivo specificato.
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo per cui selezionare un driver.
[in, out] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro è specificato, SetupDiSelectOEMDrv associa il driver selezionato al dispositivo specificato. Se questo parametro è NULL, SetupDiSelectOEMDrv associa il driver selezionato all'elenco di driver di classe globale per DeviceInfoSet.
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato da una chiamata a GetLastError.
Commenti
SetupDiSelectOEMDrv è progettato principalmente per selezionare un driver OEM per un dispositivo in un computer locale prima di installare il dispositivo in tale computer. Anche se SetupDiSelectOEMDrv non avrà esito negativo 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 con richieste di installazione DIF_Xxx o funzioni SetupDiXxx che non supportano le operazioni in un computer remoto. In particolare, il set di informazioni sul dispositivo non può essere usato come input con una richiesta di installazione DIF_INSTALLDEVICE per installare un dispositivo in un computer remoto.
SetupDiSelectOEMDrv richiede all'utente il percorso OEM e quindi chiama il programma di installazione della classe per selezionare un driver dal percorso OEM.
Requisiti
| 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 |
| DLL | Setupapi.dll |