EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART função de retorno de chamada (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada de evento EvtDeviceSelfManagedIoRestart de um driver reinicia as operações de E/S autogerenciadas de um dispositivo.
Sintaxe
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;
NTSTATUS EvtWdfDeviceSelfManagedIoRestart(
[in] WDFDEVICE Device
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
Retornar valor
Se a função de retorno de chamada EvtDeviceSelfManagedIoRestart não encontrar erros, ela deverá retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE. Se NT_SUCCESS(status) for igual a FALSE, a estrutura interromperá o dispositivo e descarregará os drivers do dispositivo.
Se NT_SUCCESS(status) for igual a FALSE, a estrutura chamará as funções de retorno de chamada EvtDeviceSelfManagedIoFlush e EvtDeviceSelfManagedIoCleanup do driver.
Para obter mais informações sobre os valores retornados dessa função de retorno de chamada, consulte Relatando falhas de dispositivo.
Comentários
Para registrar uma função de retorno de chamada EvtDeviceSelfManagedIoRestart , um driver deve chamar WdfDeviceInitSetPnpPowerEventCallbacks.
Se o driver tiver registrado uma função de retorno de chamada EvtDeviceSelfManagedIoRestart , a estrutura a chamará sempre que o dispositivo retornar de um estado de baixa potência para seu estado de trabalho (D0). A estrutura chama a função de retorno de chamada EvtDeviceSelfManagedIoRestart somente depois de chamar a função de retorno de chamada EvtDeviceSelfManagedIoSuspend do driver.
A função de retorno de chamada EvtDeviceSelfManagedIoRestart do driver deve fazer o que for necessário para retomar as operações de E/S autogerenciadas do dispositivo.
Para obter mais informações sobre quando a estrutura chama essa função de retorno de chamada, consulte Cenários de gerenciamento de energia e PnP.
Para obter mais informações sobre drivers que fornecem essa função de retorno de chamada, consulte Usando Self-Managed E/S.
A função de retorno de chamada EvtDeviceSelfManagedIoRestart é chamada em IRQL = PASSIVE_LEVEL. Você não deve tornar essa função de retorno de chamada paginável.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Versão mínima do UMDF | 2,0 |
| Cabeçalho | wdfdevice.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL (consulte a seção Comentários) |