Función SetupDiCreateDeviceInfoList (setupapi.h)
La función SetupDiCreateDeviceInfoList crea un conjunto de información de dispositivo vacío y, opcionalmente, asocia el conjunto a una clase de configuración de dispositivo y una ventana de nivel superior.
Sintaxis
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent
);
Parámetros
[in, optional] ClassGuid
Puntero al GUID de la clase de configuración de dispositivo que se va a asociar al conjunto de información del dispositivo recién creado. Si se especifica este parámetro, solo los dispositivos de esta clase se pueden incluir en este conjunto de información del dispositivo. Si este parámetro se establece en NULL, el conjunto de información del dispositivo no está asociado a una clase de configuración de dispositivo específica.
[in, optional] hwndParent
Identificador de la ventana de nivel superior que se va a usar para cualquier interfaz de usuario relacionada con acciones no específicas del dispositivo (por ejemplo, un cuadro de diálogo seleccionar dispositivo que usa la lista global de controladores de clase). Este identificador es opcional y puede ser NULL. Si no se requiere una ventana de nivel superior específica, establezca hwndParent en NULL.
Valor devuelto
La función devuelve un identificador a un conjunto de información de dispositivo vacío si se realiza correctamente. De lo contrario, devuelve INVALID_HANDLE_VALUE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
El autor de la llamada de esta función debe eliminar la información de dispositivo devuelta establecida cuando ya no es necesaria llamando a SetupDiDestroyDeviceInfoList.
Para crear una lista de información de dispositivos para un equipo remoto, use SetupDiCreateDeviceInfoListEx.
Requisitos
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |
| Conjunto de API | ext-ms-win-setupapi-classinstallers-l1-1-1 (introducido en Windows 8.1) |