Función SetupDiEnumDriverInfoW (setupapi.h)

  • Artículo

La función SetupDiEnumDriverInfo enumera los miembros de una lista de controladores.

Sintaxis

WINSETUPAPI BOOL SetupDiEnumDriverInfoW(
  [in]           HDEVINFO           DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA   DeviceInfoData,
  [in]           DWORD              DriverType,
  [in]           DWORD              MemberIndex,
  [out]          PSP_DRVINFO_DATA_W DriverInfoData
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene la lista de controladores que se va a enumerar.

[in, optional] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica un elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiEnumDriverInfo enumera una lista de controladores para el dispositivo especificado. Si este parámetro es NULL, SetupDiEnumDriverInfo enumera la lista global de controladores de clase asociada a DeviceInfoSet (esta lista es de tipo SPDIT_CLASSDRIVER).

[in] DriverType

Tipo de lista de controladores que se va a enumerar, que debe ser uno de los siguientes valores:

SPDIT_CLASSDRIVER

Enumerar una lista de controladores de clase. Este tipo de lista de controladores debe especificarse si no se especifica DeviceInfoData .

SPDIT_COMPATDRIVER

Enumerar una lista de controladores compatibles para el dispositivo especificado. Este tipo de lista de controladores solo se puede especificar si también se especifica DeviceInfoData .

[in] MemberIndex

Índice de base cero del miembro de información del controlador que se va a recuperar.

[out] DriverInfoData

Puntero a una estructura de SP_DRVINFO_DATA inicializada por el autor de la llamada que recibe información sobre el controlador enumerado. El autor de la llamada debe establecer DriverInfoData.cbSize a sizeof(SP_DRVINFO_DATA) antes de llamar a SetupDiEnumDriverInfo. Si el miembro cbSize no está configurado correctamente, SetupDiEnumDriverInfo devolverá FALSE.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.

Comentarios

Para enumerar los miembros del conjunto de información del controlador, un instalador debe llamar primero a SetupDiEnumDriverInfo con el parámetro MemberIndex establecido en 0. Después, debe incrementar MemberIndex y llamar a SetupDiEnumDriverInfo hasta que no haya más valores. Cuando no hay más valores, se produce un error en la función y una llamada a GetLastError devuelve ERROR_NO_MORE_ITEMS.

Si no inicializa correctamente el miembro cbSize de la estructura de SP_DRVINFO_DATA proporcionada por el puntero DriverInfoData, se producirá un error en la función y se registrará el error ERROR_INVALID_USER_BUFFER.

Para crear una lista de controladores asociados a un dispositivo específico o con la lista de controladores de clase global para un conjunto de información del dispositivo, use primero SetupDiBuildDriverInfoList y, a continuación, pase esa lista a SetupDiEnumDriverInfo.

Nota

El encabezado setupapi.h define SetupDiEnumDriverInfo como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
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

Consulte también

SetupDiBuildDriverInfoList