estructura SP_DRVINFO_DATA_V1_A (setupapi.h)

Una estructura 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 compatible con 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. Normalmente es el nombre de la organización que crea el controlador o el archivo INF. ProviderName puede ser una cadena vacía.

Observaciones

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 DriverDate ni miembros DriverVersion.

funciones de SetupDiXxx que toman una estructura de SP_DRVINFO_DATA como parámetro comprueban que el cbSize miembro de la estructura proporcionada es 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 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
encabezado de	setupapi.h (incluya Setupapi.h)

Consulte también

setupDiEnumDriverInfo

setupDiGetDriverInstallParams

SetupDiGetSelectedDriver

SetupDiSetDriverInstallParams

SetupDiSetSelectedDriver