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 |