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

Confira também

EvtDeviceQueryRemove