Função UcmConnectorDataDirectionChanged (ucmmanager.h)

Notifica a extensão da estrutura do gerenciador de conectores USB (UcmCx) com a nova função de dados de uma alteração na função de dados.

Sintaxe

void UcmConnectorDataDirectionChanged(
  [in] UCMCONNECTOR  Connector,
  [in] BOOLEAN       Success,
  [in] UCM_DATA_ROLE CurrentDataRole
);

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 dados iniciada pelo UcmCx usando EVT_UCM_CONNECTOR_SET_DATA_ROLE.

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

[in] CurrentDataRole

Um valor UCM_TYPEC_PARTNER que indica a nova função de dados.

Retornar valor

Nenhum

Comentários

UcmConnectorDataDirectionChanged 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 dados do parceiro dependendo do valor CurrentDataRole . Por exemplo, se o driver do cliente alterar a função de dados para UcmTypeCPortStateUfp, o UcmCx atualizará a função do parceiro do conector para UcmTypeCPortStateDfp.

UcmCx pode alterar a função de dados de um conector e invoca EVT_UCM_CONNECTOR_SET_DATA_ROLE. Em resposta a essa chamada, o cliente deve executar a operação DR_Swap e indicar êxito/falha da operação chamando UcmConnectorDataDirectionChanged.

Como alternativa, o driver 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 UcmConnectorDataDirectionChanged.

Requisitos

Confira também

• UcmConnectorCreate