Função UcmConnectorPowerDirectionChanged (ucmmanager.h)
Notifica a extensão da estrutura do gerenciador de conectores USB (UcmCx) com a nova função de energia do conector de 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 com tipo UCM_POWER_ROLEque indica a nova função de dados.
Valor de retorno
Nenhum
Observações
ucmConnectorPowerDirectionChanged 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 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 de PR_Swap e indicar êxito/falha da operação chamando ucmConnectorPowerDirectionChanged.
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 ucmConnectorPowerDirectionChanged.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 |
| servidor com suporte mínimo | Windows Server 2016 |
| da 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 |