EVT_UDECX_USB_DEVICE_SET_FUNCTION_SUSPEND_AND_WAKE função de retorno de chamada (udecxusbdevice.h)
A extensão da classe de emulação de dispositivo USB (UdeCx) invoca essa função de retorno de chamada quando recebe uma solicitação para alterar o estado da função da interface especificada do dispositivo USB 3.0 virtual.
Sintaxe
EVT_UDECX_USB_DEVICE_SET_FUNCTION_SUSPEND_AND_WAKE EvtUdecxUsbDeviceSetFunctionSuspendAndWake;
NTSTATUS EvtUdecxUsbDeviceSetFunctionSuspendAndWake(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] ULONG Interface,
[in] UDECX_USB_DEVICE_FUNCTION_POWER FunctionPower
)
{...}
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.
[in] Interface
Esse valor é o bInterfaceNumber da interface que está acordando.
[in] FunctionPower
Um valor de tipo UDECX_USB_DEVICE_FUNCTION_POWERque indica se a interface pode suspender e enviar o sinal de ativação para o controlador de host.
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.
Essa função de retorno de chamada de evento se aplica a dispositivos USB 3.0+. O UdeCx invoca essa função para notificar o driver cliente de uma solicitação para alterar o estado de energia de uma função específica. Ele também informa ao driver se a função pode ou não ser ativada do novo estado.
A solicitação de energia pode ser concluída de forma assíncrona retornando STATUS_PENDING e, posteriormente, concluindo-a chamando UdecxUsbDeviceSetFunctionSuspendAndWakeComplete 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)