estructura de SP_DEVICE_INTERFACE_DATA (setupapi.h)

Artículo
03/13/2024

Una estructura de SP_DEVICE_INTERFACE_DATA define una interfaz de dispositivo en un conjunto de información del dispositivo.

Sintaxis

typedef struct _SP_DEVICE_INTERFACE_DATA {
  DWORD     cbSize;
  GUID      InterfaceClassGuid;
  DWORD     Flags;
  ULONG_PTR Reserved;
} SP_DEVICE_INTERFACE_DATA, *PSP_DEVICE_INTERFACE_DATA;

Miembros

cbSize

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

InterfaceClassGuid

GUID de la clase a la que pertenece la interfaz del dispositivo.

Flags

Uno o varios de los siguientes:

SPINT_ACTIVE

La interfaz está activa (habilitada).

SPINT_DEFAULT

La interfaz es la interfaz predeterminada para la clase de dispositivo.

SPINT_REMOVED

La interfaz se quita.

Reserved

Reservado. No utilizar.

Comentarios

Una función SetupAPI que toma una instancia de la estructura SP_DEVICE_INTERFACE_DATA como parámetro comprueba si el miembro cbSize de la estructura proporcionada es igual al tamaño, en bytes, de la estructura. Si el miembro cbSize no se ha ajustado correctamente, se producirá un error en la función y se establecerá un código de error de ERROR_INVALID_USER_BUFFER.