Funzione SetupDiCreateDeviceInfoList (setupapi.h)
La funzione SetupDiCreateDeviceInfoList crea un set di informazioni sul dispositivo vuoto e associa facoltativamente il set a una classe di installazione del dispositivo e a una finestra di primo livello.
Sintassi
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent
);
Parametri
[in, optional] ClassGuid
Puntatore al GUID della classe di installazione del dispositivo da associare al set di informazioni sul dispositivo appena creato. Se questo parametro è specificato, è possibile includere solo i dispositivi di questa classe in questo set di informazioni sul dispositivo. Se questo parametro è impostato su NULL, il set di informazioni sul dispositivo non è associato a una classe di configurazione del dispositivo specifica.
[in, optional] hwndParent
Handle della finestra di primo livello da usare per qualsiasi interfaccia utente correlata a azioni non specifiche del dispositivo, ad esempio una finestra di dialogo select-device che usa l'elenco di driver di classe globale. Questo handle è facoltativo e può essere NULL. Se non è necessaria una finestra di primo livello specifica, impostare hwndParent su NULL.
Valore restituito
La funzione restituisce un handle a un set di informazioni sul dispositivo vuoto se ha esito positivo. In caso contrario, restituisce INVALID_HANDLE_VALUE. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Il chiamante di questa funzione deve eliminare le informazioni sul dispositivo restituite quando non è più necessario chiamando SetupDiDestroyDeviceInfoList.
Per creare un elenco di informazioni sul dispositivo per un computer remoto, usare SetupDiCreateDeviceInfoListEx.
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 |
Set di API | ext-ms-win-setupapi-classinstallers-l1-1-1 (introdotto in Windows 8.1) |