PoUnregisterPowerSettingCallback function (wdm.h)

  • Article

The PoUnregisterPowerSettingCallback routine unregisters a power-setting callback routine that a driver previously registered by calling the PoRegisterPowerSettingCallback routine.

Syntax

NTSTATUS PoUnregisterPowerSettingCallback(
  [in, out] PVOID Handle
);

Parameters

[in, out] Handle

A handle to a callback routine that a driver registered by calling PoRegisterPowerSettingCallback.

Return value

PoUnregisterPowerSettingCallback returns one of the following:

Return code Description
STATUS_SUCCESS
 The callback routine was unregistered.
STATUS_INVALID_PARAMETER
 The Handle value is not a valid handle to a power setting callback routine.

Remarks

A driver calls PoUnregisterPowerSettingCallback to unregister a power setting callback routine that the driver previously registered by calling PoRegisterPowerSettingCallback.

A driver must call PoUnregisterPowerSettingCallback to unregister each callback routine that it previously registered. All callback routines registered by a driver should be unregistered in the Unload routine of the driver.

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 PASSIVE_LEVEL

See also

PoRegisterPowerSettingCallback