função de retorno de chamada EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION (ucxcontroller.h)

  • Artigo

O UCX invoca essa função de retorno de chamada para especificar sua preferência em características de transporte para as quais o driver cliente deve enviar notificações quando ocorrerem alterações.

Sintaxe

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;

void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
  [in] UCXCONTROLLER UcxController,
  [in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}

Parâmetros

[in] UcxController

Um identificador para o controlador UCX que o driver cliente recebeu em uma chamada anterior para o método UcxControllerCreate .

[in] ChangeNotificationFlags

Uma opção bit a bit de sinalizadores que indicam as características de transporte de tipo nas quais o UCX está interessado. Os sinalizadores são definidos em UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS.

Retornar valor

Nenhum

Comentários

Se a operação for bem-sucedida, a função de retorno de chamada deverá retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE.

O driver cliente UCX registra sua implementação com a UCX (extensão do controlador de host USB) chamando o método UcxControllerCreate .

Para consumo eficiente de energia, o UCX invoca essa função de retorno de chamada para especificar as características de transporte nas quais o UCX está interessado.

É provável que, se o driver cliente continuar procurando alterações nas características de transporte no controlador. Isso pode resultar em um alto consumo de energia e pode ser ineficiente se não houver drivers de dispositivo USB registrados para essa notificação de alteração. Para otimizar o consumo de energia, o UCX invoca essa função de retorno de chamada para informar o driver cliente se algum cliente está registrado para alterações. Essa função de retorno de chamada passa os sinalizadores de notificação de alteração como parâmetro. Se um sinalizador estiver definido, ele indicará que há pelo menos um driver de dispositivo registrado. Se o sinalizador não estiver definido, isso significa que não há clientes registrados e, portanto, o controlador pode otimizar a energia.

Observação

É opcional que os drivers do controlador registrem ou usem essas funções de retorno de chamada. É válido que um driver de controlador invoque a notificação de alteração mesmo que o UCX tenha indicado que não há clientes registrados para ele.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho ucxcontroller.h (inclua Ucxclass.h)
IRQL PASSIVE_LEVEL

Confira também