UcmConnectorTypeCCurrentAdChanged function (ucmmanager.h)

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

See also

UcmConnectorCreate

UcmConnectorTypeCAttach

UcmConnectorTypeCCurrentAdChanged