(setupapi.h) SP_DEVICE_INTERFACE_DATA 结构

项目
03/01/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

保留。请勿使用。

注解

采用 SP_DEVICE_INTERFACE_DATA 结构的实例作为参数的 SetupAPI 函数验证提供的结构的 cbSize 成员是否等于结构的大小（以字节为单位）。如果未正确设置 cbSize 成员，则函数将失败，并将错误代码设置为 ERROR_INVALID_USER_BUFFER。