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

Artigo
02/07/2025

A implementação do driver cliente que o UCX chama quando a porta à qual o dispositivo está anexado é redefinida.

Sintaxe

EVT_UCX_USBDEVICE_RESET EvtUcxUsbdeviceReset;

void EvtUcxUsbdeviceReset(
  [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

Contém a estrutura USBDEVICE_RESET.

Valor de retorno

Nenhum

Observações

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

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 cliente retorna o status de conclusão no de Solicitação. O driver pode concluir o WDFREQUEST de forma assíncrona.

Exemplos

VOID
UsbDevice_EvtUcxUsbDeviceReset(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceReset");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceReset = (PUSBDEVICE_RESET)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Requisitos

Requisito	Valor
da 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

Consulte também

USBDEVICE_RESET

UcxUsbDeviceCreate

Compartilhar via