estructura de SP_DEVINFO_DATA (setupapi.h)

Una estructura de SP_DEVINFO_DATA define una instancia de dispositivo que es miembro de un conjunto de información de dispositivo.

Sintaxis

typedef struct _SP_DEVINFO_DATA {
  DWORD     cbSize;
  GUID      ClassGuid;
  DWORD     DevInst;
  ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;

Miembros

cbSize

Tamaño, en bytes, de la estructura SP_DEVINFO_DATA. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

ClassGuid

GUID de la clase de configuración del dispositivo.

DevInst

Un identificador opaco para la instancia del dispositivo (también conocido como identificador para el devnode).

Algunas funciones, como las funciones SetupDiXxx , toman toda la estructura de SP_DEVINFO_DATA como entrada para identificar un dispositivo en un conjunto de información del dispositivo. Otras funciones, como las funciones CM_Xxx , como CM_Get_DevNode_Status, toman este identificador de DevInst como entrada.

Reserved

Reservado. Solo para uso interno.

Comentarios

Una estructura de SP_DEVINFO_DATA identifica un dispositivo en un conjunto de información del dispositivo. Por ejemplo, cuando Windows envía una solicitud de DIF_INSTALLDEVICE a un instalador de clase y co-installers, incluye un identificador para un conjunto de información del dispositivo y un puntero a un SP_DEVINFO_DATA que especifica el dispositivo determinado. Además de las solicitudes DIF, esta estructura también se usa en algunas funciones SetupDiXxx .

Las funciones SetupDiXxx que toman una estructura de SP_DEVINFO_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.

Requisitos

Consulte también

SP_DEVINFO_LIST_DETAIL_DATA