Función SetupDiGetDriverInfoDetailW (setupapi.h)

  • Artículo

La función SetupDiGetDriverInfoDetail recupera detalles de información del controlador para un conjunto de información del dispositivo o un elemento de información de dispositivo determinado en el conjunto de información del dispositivo.

Sintaxis

WINSETUPAPI BOOL SetupDiGetDriverInfoDetailW(
  [in]            HDEVINFO                  DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA          DeviceInfoData,
  [in]            PSP_DRVINFO_DATA_W        DriverInfoData,
  [in, out]       PSP_DRVINFO_DETAIL_DATA_W DriverInfoDetailData,
  [in]            DWORD                     DriverInfoDetailDataSize,
  [out, optional] PDWORD                    RequiredSize
);

Parámetros

[in] DeviceInfoSet

Identificador de un conjunto de información del dispositivo que contiene un elemento de información del controlador para el que se va a recuperar la información del controlador.

[in, optional] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica un elemento de información del dispositivo que representa el dispositivo para el que se va a recuperar la información del controlador. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiGetDriverInfoDetail recupera información sobre un controlador de una lista de controladores para el dispositivo especificado. Si este parámetro es NULL, SetupDiGetDriverInfoDetail recupera información sobre un controlador que es miembro de la lista global de controladores de clase para DeviceInfoSet.

[in] DriverInfoData

Puntero a una estructura SP_DRVINFO_DATA que especifica el elemento de información del controlador que representa el controlador para el que se van a recuperar los detalles. Si se especifica DeviceInfoData , el controlador debe ser miembro de la lista de controladores del dispositivo especificado por DeviceInfoData. De lo contrario, el controlador debe ser miembro de la lista global de controladores de clase para DeviceInfoSet.

[in, out] DriverInfoDetailData

Puntero a una estructura SP_DRVINFO_DETAIL_DATA que recibe información detallada sobre el controlador especificado. Si no se especifica este parámetro, DriverInfoDetailDataSize debe ser cero. Si se especifica este parámetro, DriverInfoDetailData.cbSize debe establecerse en el valor de sizeof(SP_DRVINFO_DETAIL_DATA) antes de llamar a SetupDiGetDriverInfoDetail.

NotaDriverInfoDetailData.cbSize no debe establecerse en el valor del parámetro DriverInfoDetailDataSize.
 

[in] DriverInfoDetailDataSize

Tamaño, en bytes, del búfer DriverInfoDetailData .

[out, optional] RequiredSize

Puntero a una variable que recibe el número de bytes necesarios para almacenar la información detallada del controlador. Este valor incluye tanto el tamaño de la estructura como los bytes adicionales necesarios para el búfer de caracteres de longitud variable al final que contiene la lista de identificadores de hardware y la lista de identificadores compatibles. Las listas están en formato REG_MULTI_SZ. Para obtener información sobre el hardware y los identificadores compatibles, consulte Cadenas de identificación de dispositivos.

Valor devuelto

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

Comentarios

Si el miembro de información del controlador especificado y el búfer proporcionado por el autor de la llamada son válidos, se garantiza que esta función rellene todos los campos estáticos de la estructura SP_DRVINFO_DETAIL_DATA y tantos identificadores como sea posible en el búfer de longitud variable al final mientras se mantiene REG_MULTI_SZ formato. En este caso, la función devuelve FALSE y una llamada a GetLastError devuelve ERROR_INSUFFICIENT_BUFFER. Si se especifica, RequiredSize contiene el número total de bytes necesarios para la estructura con todos los identificadores.

Nota

El encabezado setupapi.h define SetupDiGetDriverInfoDetail 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

SetupDiEnumDriverInfo

SetupDiGetSelectedDriver