Partilhar via


EVT_WDF_DEVICE_QUERY_STOP função de retorno de chamada (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 os 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.

Valor de retorno

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 de status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor de status para o qual NT_SUCCESS(status) é igual a FALSE. Não retorne STATUS_NOT_SUPPORTED.

Observações

Para registrar uma função de retorno de chamada EvtDeviceQueryStop, um driver deve chamar WdfDeviceInitSetPnpPowerEventCallbacks.

Se o dispositivo e o driver derem suporte à alimentação ociosa, o dispositivo poderá não estar em seu estado de trabalho quando a estrutura chamar o do driver EvtDeviceQueryStop função de retorno de chamada. A função de retorno de chamada pode chamar WdfDeviceStopIdle para forçar o dispositivo a entrar 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 tratando solicitações para interromper 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 Usandode Sincronização Automática.

Requisitos

Requisito Valor
da 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 também

EvtDeviceQueryRemove