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.

Valor de retorno

Nenhum

Observações

ucmConnectorDataDirectionChanged retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função embutida pode retornar um valor de 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 cliente alterar a função de dados para ucmTypeCPortStateUfp, o UcmCx atualizará a função do parceiro conector para ucmTypeCPortStateDfp.

O 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 ao UcmCx usando ucmConnectorDataDirectionChanged.

Requisitos

Consulte também

• UcmConnectorCreate