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

Artigo
02/07/2025

O UCX invoca esse retorno de chamada para recuperar as características do controlador de host.

Sintaxe

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

Parâmetros

[in] UcxController

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

[out] UcxControllerTransportCharacteristics

Um ponteiro para uma estrutura UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS que o driver cliente do controlador de host preenche com características de transporte.

Valor de retorno

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

Observações

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

Essa função de retorno de chamada é opcional. Sempre que as características de transporte são alteradas, o driver cliente é responsável por notificar o UCX de que uma das características foi alterada usando uma nova função UcxControllerNotifyTransportCharacteristicsChange.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1709
servidor com suporte mínimo	Windows Server 2016
da 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

Consulte também

UcxControllerCreate

Compartilhar via