Compartilhar via


EVT_UDECX_USB_DEVICE_D0_ENTRY função de retorno de chamada (udecxusbdevice.h)

A extensão de classe de emulação de dispositivo USB (UdeCx) invoca essa função de retorno de chamada quando obtém uma solicitação para tirar o dispositivo USB virtual de um estado de baixa energia para o estado de trabalho.

Sintaxe

EVT_UDECX_USB_DEVICE_D0_ENTRY EvtUdecxUsbDeviceD0Entry;

NTSTATUS EvtUdecxUsbDeviceD0Entry(
  [in] WDFDEVICE UdecxWdfDevice,
  [in] UDECXUSBDEVICE UdecxUsbDevice
)
{...}

Parâmetros

[in] UdecxWdfDevice

Um identificador para um objeto de dispositivo de estrutura que representa o controlador ao qual o dispositivo USB está anexado. O driver cliente inicializou esse objeto em uma chamada anterior para UdecxWdfDeviceAddUsbDeviceEmulation.

[in] UdecxUsbDevice

Um identificador para o objeto do dispositivo UDE. O driver cliente criou esse objeto em uma chamada anterior para UdecxUsbDeviceCreate.

Valor de retorno

Se a operação for bem-sucedida, a função de retorno de chamada deverá retornar STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE.

Observações

O driver cliente registrou a função em uma chamada anterior para UdecxUsbDeviceInitSetStateChangeCallbacks fornecendo um ponteiro de função para sua implementação.

Na implementação do retorno de chamada, espera-se que o driver cliente do dispositivo USB execute etapas para entrar no estado de trabalho.

A solicitação de energia pode ser concluída de forma assíncrona retornando STATUS_PENDING e, posteriormente, concluindo-a chamando UdecxUsbDeviceLinkPowerExitComplete com o código de conclusão real.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10
servidor com suporte mínimo Windows Server 2016
da Plataforma de Destino Windows
versão mínima do KMDF 1.15
cabeçalho udecxusbdevice.h (inclua Udecx.h)
IRQL <=DISPATCH_LEVEL

Consulte também

Arquitetura : UDE (Emulação de Dispositivo USB)

EVT_UDECX_USB_DEVICE_D0_EXIT

UdecxUsbDeviceLinkPowerExitComplete

UdecxUsbDeviceSignalWake

gravar um driver de cliente UDE