Función SetupDiCreateDeviceInfoList (setupapi.h)

  • Artículo

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)

Consulte también

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass