função de retorno de chamada EVT_UDECX_USB_DEVICE_D0_ENTRY (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 do 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.
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.
Comentários
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 do cliente para o 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 |
|---|---|
| Cliente mínimo com suporte | Windows 10 |
| Servidor mínimo com suporte | Windows Server 2016 |
| Plataforma de Destino | Windows |
| Versão mínima do KMDF | 1.15 |
| Cabeçalho | udecxusbdevice.h (inclua Udecx.h) |
| IRQL | <=DISPATCH_LEVEL |
Confira também
Arquitetura: UDE (Emulação de Dispositivo USB)