EVT_UCX_USBDEVICE_DISABLE função de retorno de chamada (ucxusbdevice.h)
A implementação do driver cliente que o UCX chama para liberar recursos do controlador associados ao dispositivo e seu ponto de extremidade padrão.
Sintaxe
EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;
void EvtUcxUsbdeviceDisable(
[in] UCXCONTROLLER UcxController,
[in] WDFREQUEST Request
)
{...}
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] Request
Uma estrutura do tipo USBDEVICE_DISABLE.
Retornar valor
Nenhum
Comentários
O driver cliente UCX registra essa função de retorno de chamada com a UCX (extensão do controlador de host USB) chamando o método UcxUsbDeviceCreate .
Quando o driver cliente libera recursos do controlador, ele conclui o WDFREQUEST. Após a conclusão, a única função de retorno de chamada que o UCX chama referenciando esse dispositivo USB é EVT_UCX_USBDEVICE_ENABLE.
Embora o dispositivo esteja desabilitado, o UCX não agenda transferências para ele.
Para fazer a transição do dispositivo para o estado desejado, o driver do controlador de host se comunica com o hardware para concluir a solicitação.
O driver do cliente retorna status de conclusão na Solicitação. O driver pode concluir o WDFREQUEST de forma assíncrona.
Exemplos
VOID
UsbDevice_EvtUcxUsbDeviceDisable(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
usbDeviceDisable = (PUSBDEVICE_DISABLE)wdfRequestParams.Parameters.Others.Arg1;
...
WdfRequestComplete(Request, STATUS_SUCCESS);
}
Requisitos
Requisito | Valor |
---|---|
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 |