EVT_UCX_USBDEVICE_GET_CHARACTERISTIC função de retorno de chamada (ucxusbdevice.h)

Artigo
02/07/2025

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

Sintaxe

EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;

NTSTATUS EvtUcxUsbdeviceGetCharacteristic(
  [in]      UCXCONTROLLER UcxController,
  [in]      UCXUSBDEVICE UcxUsbDevice,
  [in, out] PUCX_USBDEVICE_CHARACTERISTIC UcxUsbDeviceCharacteristic
)
{...}

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] UcxUsbDevice

Um identificador para um objeto UCX que representa o dispositivo USB que o driver cliente recebeu em uma chamada anterior para o método ucxUsbDeviceCreate.

[in, out] UcxUsbDeviceCharacteristic

Um ponteiro para uma estrutura de UCX_USBDEVICE_CHARACTERISTIC que contém o tipo de característica em que o chamador está interessado. O driver cliente preenche o valor da característica solicitada. Por exemplo, se o tipo indicar UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY, o driver preencherá a estrutura de UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY, apontada por membro PathDelay, com o máximo apropriado e os valores de atraso de caminho de envio.

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 UcxUsbDeviceCreate.

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	ucxusbdevice.h (inclua Ucxclass.h)
IRQL	<=DISPATCH_LEVEL

Compartilhar via