USBPM_CONNECTOR_STATE 结构 (usbpmapi.h)

描述连接器的状态。 此结构用于 UsbPm_RetrieveConnectorState 调用。 客户端驱动程序必须通过调用 USBPM_CONNECTOR_STATE_INIT 来初始化此结构。

语法

typedef struct _USBPM_CONNECTOR_STATE {
  USBPM_CONNECTOR             ConnectorHandle;
  ULONG                       ChangeToken;
  BOOLEAN                     Attached;
  ULONG                       AttachCount;
  USBC_PARTNER                Partner;
  USBC_CURRENT                CurrentAdvertisement;
  USBC_PD_CONN_STATE          PdConnState;
  USBC_PD_REQUEST_DATA_OBJECT Rdo;
  USBC_DATA_ROLE              DataRole;
  USBC_POWER_ROLE             PowerRole;
  UINT8                       SourceCapsCount;
  USBC_PD_POWER_DATA_OBJECT   SourceCaps[USBPM_MAX_CAPS_COUNT];
  UINT8                       SinkCapsCount;
  USBC_PD_POWER_DATA_OBJECT   SinkCaps[USBPM_MAX_CAPS_COUNT];
  UINT8                       PartnerSourceCapsCount;
  USBC_PD_POWER_DATA_OBJECT   PartnerSourceCaps[USBPM_MAX_CAPS_COUNT];
  ULONG                       PdAlternateModesEnteredCount;
} USBPM_CONNECTOR_STATE, *PUSBPM_CONNECTOR_STATE;

成员

ConnectorHandle

此连接器的句柄。

ChangeToken

此状态的更改标记编号。 每次更改连接器状态时，都会更改此值。

Attached

指示是否附加此连接器。

AttachCount

指示此连接器上发生的附加事件数。 如果客户端驱动程序看到从一个“附加”状态转换为另一个“附加”状态，但“AttachCount”不同，则表示两个附加和两个不同的端口伙伴。

Partner

端口伙伴的类型，在 USBC_PARTNER 枚举中定义。

CurrentAdvertisement

当前播发的 Type-C 的数量。

PdConnState

指示此连接器上的连接的 PD 协定状态。

Rdo

已发送到此连接器的端口伙伴的 PD 请求数据对象。 请参阅 USBC_PD_REQUEST_DATA_OBJECT。

DataRole

指示连接器的 USB 类型 C 数据角色，在 USBC_DATA_ROLE 枚举中定义。

PowerRole

指示连接器的 USB Type-C 电源角色， 在 USBC_POWER_ROLE 枚举中定义。

SourceCapsCount

源数组中的电源数据对象数上限。

SourceCaps[USBPM_MAX_CAPS_COUNT]

连接器的源功能。 请参阅 USBC_PD_POWER_DATA_OBJECT。

SinkCapsCount

相应数组中的电源数据对象数。

SinkCaps[USBPM_MAX_CAPS_COUNT]

连接器的接收器功能。 请参阅 USBC_PD_POWER_DATA_OBJECT。

PartnerSourceCapsCount

相应数组中的电源数据对象数。

PartnerSourceCaps[USBPM_MAX_CAPS_COUNT]

相应数组中端口伙伴的源功能。 请参阅 USBC_PD_POWER_DATA_OBJECT。

PdAlternateModesEnteredCount

输入的备用模式数。

要求

要求	值
最低受支持的客户端	Windows 10 版本 1809
最低 KMDF 版本	1.27
最低 UMDF 版本	2.27
标头	usbpmapi.h