Funzione SetupDiSelectDevice (setupapi.h)

Articolo
03/01/2024

La funzione SetupDiSelectDevice è il gestore predefinito per la richiesta di DIF_SELECTDEVICE .

Sintassi

WINSETUPAPI BOOL SetupDiSelectDevice(
  [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 cui selezionare un driver.

[in, out] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiSelectDevice seleziona il driver per il dispositivo specificato e imposta DeviceInfoData.ClassGuid al GUID della classe di installazione del dispositivo per il driver selezionato. Se questo parametro è NULL, SetupDiSelectDevice imposta il driver selezionato nell'elenco di driver di classe globale per DeviceInfoSet.

Valore restituito

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

Commenti

SetupDiSelectDevice gestisce l'interfaccia utente che consente all'utente di selezionare un driver per il dispositivo specificato o un set di informazioni sul dispositivo se non è specificato un dispositivo. Impostando il campo Flags della struttura SP_DEVINSTALL_PARAMS per il dispositivo o le informazioni sul dispositivo impostate se un dispositivo non è specificato, il chiamante può specificare una gestione speciale dell'interfaccia utente, ad esempio per consentire agli utenti di selezionare un driver da un disco di installazione OEM.

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

SetupDiSelectDevice è progettato principalmente per selezionare un driver per un dispositivo in un computer locale prima di installare il dispositivo. Anche se SetupDiSelectDevice non avrà esito negativo se il set di informazioni sul dispositivo è destinato a un computer remoto, il risultato è limitato perché il set di informazioni sul dispositivo non può essere usato successivamente con le richieste di installazione DIF_Xxx o le 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.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft 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

SP_DEVINSTALL_PARAMS

SetupDiCallClassInstaller

Condividi tramite