структура SP_DEVICE_INTERFACE_DATA (setupapi.h)

Статья
03/09/2024

Структура SP_DEVICE_INTERFACE_DATA определяет интерфейс устройства в наборе сведений об устройстве.

Синтаксис

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

Члены

cbSize

Размер структуры SP_DEVICE_INTERFACE_DATA в байтах. Дополнительные сведения см. в разделе «Примечания».

InterfaceClassGuid

GUID для класса, к которому принадлежит интерфейс устройства.

Flags

Может быть одним или несколькими из следующих вариантов:

SPINT_ACTIVE

Интерфейс активен (включен).

SPINT_DEFAULT

Интерфейс является интерфейсом по умолчанию для класса устройства.

SPINT_REMOVED

Интерфейс удален.

Reserved

Зарезервировано. Не используется.

Функция SetupAPI, которая принимает экземпляр структуры SP_DEVICE_INTERFACE_DATA в качестве параметра, проверяет, равен ли член cbSize предоставленной структуры размеру структуры в байтах. Если элемент cbSize задан неправильно, функция завершится ошибкой и установит код ошибки ERROR_INVALID_USER_BUFFER.