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

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.

Requisitos

Confira também

• UcxControllerCreate