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)

Vedi anche

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass