Função de retorno de chamada PEPCALLBACKNOTIFYDPM (pepfx.h)

Uma rotina de retorno de chamada de evento AcceptDeviceNotification manipula as notificações de DPM (gerenciamento de energia do dispositivo) da PoFx ( estrutura de gerenciamento de energia ) do Windows.

Sintaxe

PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;

BOOLEAN Pepcallbacknotifydpm(
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

Parâmetros

[in] Notification

A ID de notificação do DPM. Esse parâmetro especifica o tipo de notificação do DPM que o PoFx está enviando. Para obter uma lista de IDs de notificação do DPM, consulte Notificações de DPM (gerenciamento de energia do dispositivo).

[in, out, optional] Data

Um ponteiro para uma estrutura alocada por PoFx que contém os dados de entrada e/ou saída dessa notificação. O tipo dessa estrutura depende da ID de notificação especificada por Notificação. Para obter uma lista dos tipos de estrutura definidos para as várias IDs de notificação do DPM, consulte Notificações de DPM (gerenciamento de energia do dispositivo).

Retornar valor

A rotina AcceptDeviceNotification deverá retornar TRUE se manipular a notificação ou FALSE se não o fizer.

Comentários

Essa rotina é implementada pelo PEP (plug-in de extensão de plataforma) para um dispositivo. O membro AcceptDeviceNotification da estrutura PEP_INFORMATION é um ponteiro para uma rotina AcceptDeviceNotification . O PEP chama a rotina PoFxRegisterPlugin ou PoFxRegisterPluginEx para registrar a rotina AcceptDeviceNotification do PEP com PoFx.

O PoFx chama essa rotina para enviar uma notificação do DPM para o PEP. Nessa chamada, o parâmetro Notification especifica o tipo de notificação e o parâmetro Data aponta para uma estrutura de dados do tipo associado a essa notificação. Para obter uma lista de IDs de notificação do DPM e seus tipos de estrutura associados, consulte Notificações de gerenciamento de energia do dispositivo (DPM).

As notificações do DPM informam o PEP sobre vários eventos de nível de sistema, dispositivo ou componente, ou passam solicitações do driver do dispositivo para o PEP.

A rotina AcceptDeviceNotification não precisa aceitar todas as solicitações do driver do dispositivo, por exemplo, ela pode ignorar dicas de residência ociosas. No entanto, o PEP deve entender e aceitar a maioria das notificações de gerenciamento de energia do dispositivo, mesmo que o PEP opte por não agir sobre elas. O PEP deve se recusar a manipular (retornando FALSE) todas as notificações que não reconhece.

A rotina AcceptDeviceNotification pode ser chamada em IRQL <= DISPATCH_LEVEL. O IRQL no qual a rotina AcceptAcpiNotification do PEP é chamada varia de acordo com o tipo de notificação que está sendo enviada. O tipo de notificação é especificado pelo parâmetro Notification . Para obter mais informações, consulte as páginas de referência individuais em Notificações de gerenciamento de energia do dispositivo (DPM).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte começando com Windows 10.
Plataforma de Destino	Windows
Cabeçalho	pepfx.h (inclua Pep_x.h)
IRQL	<= DISPATCH_LEVEL

Confira também

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx