estructura de SP_DRVINFO_DATA_V1_A (setupapi.h)

Artículo
03/15/2023

Una estructura de SP_DRVINFO_DATA contiene información sobre un controlador. Esta estructura es un miembro de una lista de información de controladores que se puede asociar a una instancia de dispositivo determinada o globalmente con un conjunto de información del dispositivo.

Sintaxis

typedef struct _SP_DRVINFO_DATA_V1_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_A, *PSP_DRVINFO_DATA_V1_A;

Miembros

cbSize

Tamaño, en bytes, de la estructura SP_DRVINFO_DATA. Para obtener más información, vea la sección Comentarios de este tema.

DriverType

Tipo de controlador representado por esta estructura. Debe ser uno de los siguientes valores:

SPDIT_CLASSDRIVER

Esta estructura representa un controlador de clase.

SPDIT_COMPATDRIVER

Esta estructura representa un controlador compatible.

Reserved

Reservado. Solo para uso interno.

Description[LINE_LEN]

Cadena terminada en NULL que describe el dispositivo admitido por este controlador.

MfgName[LINE_LEN]

Cadena terminada en NULL que contiene el nombre del fabricante del dispositivo admitido por este controlador.

ProviderName[LINE_LEN]

Cadena terminada en NULL que proporciona el proveedor de este controlador. Suele ser el nombre de la organización que crea el controlador o el archivo INF. ProviderName puede ser una cadena vacía.

Comentarios

En SetupAPI.h, esta estructura equivale a SP_DRVINFO_DATA_V1 o SP_DRVINFO_DATA_V2, en función de si incluye la siguiente línea en el código fuente:

#define  USE_SP_DRVINFO_DATA_V1 1

Defina este identificador solo si el componente debe ejecutarse en Windows 98 o Millennium Edition, o en Windows NT. Si el componente solo se ejecuta en Windows 2000 y versiones posteriores de Windows, no defina el identificador. Si no se define el identificador, se usa SP_DRVINFO_DATA_V2.

SP_DRVINFO_DATA_V1 no contiene miembros DriverDate y DriverVersion .

Las funciones SetupDiXxx que toman una estructura SP_DRVINFO_DATA como parámetro comprueban que el miembro cbSize de la estructura proporcionada sea igual al tamaño, en bytes, de la estructura. Si el miembro cbSize no está configurado correctamente para un parámetro de entrada, se producirá un error en la función y se establecerá un código de error de ERROR_INVALID_PARAMETER. Si el miembro cbSize no está configurado correctamente para un parámetro de salida, se producirá un error en la función y se establecerá un código de error de ERROR_INVALID_USER_BUFFER.

Nota:

El encabezado setupapi.h define SP_DRVINFO_DATA_V1 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.