Edit

PoGetSystemWake function (wdm.h)

  • Article

The PoGetSystemWake routine determines whether a specified IRP has been marked as waking the system from a sleeping state.

Syntax

BOOLEAN PoGetSystemWake(
  [in] PIRP Irp
);

Parameters

[in] Irp

A pointer to an IRP.

Return value

PoGetSystemWake returns one of the following:

Return code Description
TRUE
 The specified IRP did cause the system to wake.
FALSE
 The specified IRP did not cause the system to wake.

Remarks

A driver calls PoGetSystemWake to determine if a specified IRP contributed to waking the system from a sleep state.

A driver in a wait/wake chain should call PoGetSystemWake on its own wait/wake IRP at completion to determine if the driver should also call PoSetSystemWake for child wait/wake IRPs that the driver is about to complete. This ensures that system wake information properly propagates throughout the entire wait/wake chain.

It is possible that several IRPs are causing the system to wake. In this case, PoGetSystemWake would return TRUE for all of the IRPs contributing to the wake event.

Requirements

Requirement Value
Minimum supported client Available starting with Windows Vista.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=DISPATCH_LEVEL

See also

PoSetSystemWake