Compartilhar via

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

  • Artigo

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

Confira também

UcxUsbDeviceCreate