UcmConnectorTypeCCurrentAdChanged function (ucmmanager.h)

Article
02/22/2024

Notifies the USB connector manager framework extension (UcmCx) when the specified connector changes the current advertisement. Either the connector changes it (when it is DFP/Source), or the partner changed it (when it is UFP/Sink).

Syntax

NTSTATUS UcmConnectorTypeCCurrentAdChanged(
  [in] UCMCONNECTOR      Connector,
  [in] UCM_TYPEC_CURRENT CurrentAdvertisement
);

Parameters

[in] Connector

Handle to the connector object that the client driver received in the previous call to UcmConnectorCreate.

[in] CurrentAdvertisement

The new current advertisement of the connector indicated by one of the UCM_TYPEC_CURRENT-typed flags.

Return value

UcmConnectorTypeCCurrentAdChanged returns STATUS_SUCCESS if the operation succeeds. Otherwise, this method can return an appropriate NTSTATUS value.

Remarks

When using a Type-C connector for charging, the partner connector sends a current advertisement when it's attached to the local connector. That initial advertisement is report to UcmCx by calling UcmConnectorTypeCAttach. During the lifetime of the connection, the current level advertised by the source might change. The client driver must notify UcmCx about that change by calling method.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Windows
Minimum KMDF version	1.15
Minimum UMDF version	2.15
Header	ucmmanager.h (include Ucmcx.h)
Library	UcmCxstub.lib
IRQL	PASSIVE_LEVEL