Função PoGetSystemWake (wdm.h)

  • Artigo

A rotina PoGetSystemWake determina se um IRP especificado foi marcado como acordando o sistema de um estado de suspensão.

Sintaxe

BOOLEAN PoGetSystemWake(
  [in] PIRP Irp
);

Parâmetros

[in] Irp

Um ponteiro para um IRP.

Retornar valor

PoGetSystemWake retorna um dos seguintes:

Código de retorno Descrição
VERDADE
 O IRP especificado fez com que o sistema acordasse.
FALSE
 O IRP especificado não fez com que o sistema acordasse.

Comentários

Um driver chama PoGetSystemWake para determinar se um IRP especificado contribuiu para acordar o sistema de um estado de suspensão.

Um driver em uma cadeia de espera/ativação deve chamar PoGetSystemWake em seu próprio IRP de espera/ativação na conclusão para determinar se o driver também deve chamar PoSetSystemWake para IRPs de espera/ativação filho que o driver está prestes a concluir. Isso garante que as informações de ativação do sistema sejam propagadas corretamente em toda a cadeia de espera/ativação.

É possível que vários IRPs estejam fazendo com que o sistema seja ativado. Nesse caso, PoGetSystemWake retornaria TRUE para todos os IRPs que contribuem para o evento wake.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows Vista.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=DISPATCH_LEVEL

Confira também

PoSetSystemWake