Função UcmConnectorPowerDirectionChanged (ucmmanager.h)

Notifica a ucmCx (extensão de estrutura do gerenciador de conectores USB) com a nova função de energia do conector do parceiro.

Sintaxe

void UcmConnectorPowerDirectionChanged(
  [in] UCMCONNECTOR   Connector,
  [in] BOOLEAN        Success,
  [in] UCM_POWER_ROLE CurrentPowerRole
);

Parâmetros

[in] Connector

Manipule para o objeto do conector que o driver cliente recebeu na chamada anterior para UcmConnectorCreate.

[in] Success

Usado para indicar a falha de uma troca de função de energia iniciada pelo UcmCx usando EVT_UCM_CONNECTOR_SET_POWER_ROLE.

Se TRUE, a operação foi bem-sucedida. FALSE, caso contrário.

[in] CurrentPowerRole

Um dos sinalizadores do tipo UCM_POWER_ROLE que indica a nova função de dados.

Retornar valor

Nenhum

Comentários

UcmConnectorPowerDirectionChanged retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função embutida pode retornar um valor NTSTATUS apropriado.

Se o parceiro do conector estiver anexado, o UcmCx atualizará a função de energia do parceiro dependendo do valor CurrentPowerRole .

O UcmCx pode alterar a função de energia de um conector e invoca EVT_UCM_CONNECTOR_SET_POWER_ROLE. Em resposta a essa chamada, o cliente deve executar a operação PR_Swap e indicar êxito/falha da operação chamando UcmConnectorPowerDirectionChanged.

Como alternativa, o driver do cliente pode optar por executar uma troca de função de forma autônoma ou o parceiro pode executar uma troca de função. Em ambos os casos, quando a troca de função for concluída, o driver deverá relatar a nova função para UcmCx usando UcmConnectorPowerDirectionChanged.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Windows
Versão mínima do KMDF	1.15
Versão mínima do UMDF	2.15
Cabeçalho	ucmmanager.h (inclua Ucmcx.h)
Biblioteca	UcmCxstub.lib
IRQL	PASSIVE_LEVEL

Confira também

• UcmConnectorCreate