função de retorno de chamada EVT_WDF_DEVICE_QUERY_STOP (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada de evento EvtDeviceQueryStop de um driver determina se um dispositivo especificado pode ser interrompido para que o gerenciador PnP possa redistribuir recursos de hardware do sistema.
Sintaxe
EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;
NTSTATUS EvtWdfDeviceQueryStop(
[in] WDFDEVICE Device
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
Retornar valor
Se o driver determinar que o dispositivo pode ser interrompido, a função de retorno de chamada EvtDeviceQueryStop 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. Não retorne STATUS_NOT_SUPPORTED.
Comentários
Para registrar uma função de retorno de chamada EvtDeviceQueryStop , um driver deve chamar WdfDeviceInitSetPnpPowerEventCallbacks.
Se o dispositivo e o driver derem suporte à desligar ociosa, o dispositivo poderá não estar em seu estado de trabalho quando a estrutura chamar a função de retorno de chamada EvtDeviceQueryStop do driver. A função de retorno de chamada pode chamar WdfDeviceStopIdle para forçar o dispositivo em seu estado de trabalho (D0) e, em seguida, a função de retorno de chamada pode chamar WdfDeviceResumeIdle antes de retornar.
Para obter mais informações sobre a função de retorno de chamada EvtDeviceQueryStop , consulte Manipulando solicitações para parar um dispositivo.
A estrutura não sincroniza a função de retorno de chamada EvtDeviceQueryStop com outras funções de retorno de chamada de gerenciamento de energia e PnP. Para obter informações sobre como a estrutura sincroniza a execução das funções de retorno de chamada de evento de um driver, consulte Usando a sincronização automática.
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 |