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 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 UCX_USBDEVICE_CHARACTERISTIC que contém o tipo de característica no qual o chamador está interessado. O driver do 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 os valores de atraso máximo e de envio apropriados.

Retornar valor

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.

Comentários

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