Función SetupDiEnumDriverInfoA (setupapi.h)
La función SetupDiEnumDriverInfo enumera los miembros de una lista de controladores.
Sintaxis
WINSETUPAPI BOOL SetupDiEnumDriverInfoA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD DriverType,
[in] DWORD MemberIndex,
[out] PSP_DRVINFO_DATA_A 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 se puede 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 de controladores de clase global 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 para sizeof(SP_DRVINFO_DATA) antes de llamar a SetupDiEnumDriverInfo. Si el miembro
Valor devuelto
La función devuelve TRUE si se ejecuta correctamente. De lo contrario, devuelve false y el error registrado se puede recuperar con una llamada a GetLastError.
Observaciones
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. A continuación, 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 pasar 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |