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

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 handle 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 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 UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY , apontada pelo membro PathDelay , com o máximo apropriado e os valores de atraso de caminho de envio.

Valor retornado

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) for igual a TRUE. Caso contrário, ele deverá retornar um valor de status para o qual NT_SUCCESS(status) é igual a FALSE.

Comentários

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

Requisitos

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