Edit

POFXCALLBACKPROCESSORIDLEVETO callback function (pep_x.h)

  • Article

The ProcessorIdleVeto routine increments or decrements the veto count for a veto code for a processor idle state.

Syntax

POFXCALLBACKPROCESSORIDLEVETO Pofxcallbackprocessoridleveto;

NTSTATUS Pofxcallbackprocessoridleveto(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] ULONG VetoReason,
  [in] BOOLEAN Increment
)
{...}

Parameters

[in] ProcessorHandle

A POHANDLE value that represents the registration of the processor (as a device) with power management framework (PoFx). The platform extension plug-in (PEP) previously received this handle from PoFx during the PEP_DPM_REGISTER_DEVICE notification that informed the PEP that the processor had been registered with PoFx.

[in] ProcessorState

The index of the processor idle state whose veto count is being incremented or decremented. The PEP previously specified the supported processor idle states in response to a PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 notification. If the PEP specified N processor idle states, valid processor idle state indexes range from 0 to N–1.

[in] VetoReason

A PEP-defined veto code that indicates why the processor idle state cannot be entered. The PEP previously specified the supported veto reasons in response to a PEP_NOTIFY_PPM_QUERY_VETO_REASONS notification. If the PEP specified M veto reasons, valid veto codes range from 1 to M.

[in] Increment

Whether to increment or decrement the veto count. Set to TRUE to increment the veto count for this veto reason, or to FALSE to decrement the count.

Whether to increment or decrement the veto count. Set to TRUE to increment the veto count for this veto reason, or to FALSE to decrement the count.

Return value

This routine does not return a value.

Remarks

This routine is implemented by the power management framework (PoFx) and is called by the platform extension plug-in (PEP). The ProcessorIdleVeto member of the PEP_KERNEL_INFORMATION_STRUCT_V3 structure is a pointer to an ProcessorIdleVeto routine.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 10.
Target Platform Windows
Header pep_x.h (include Pep_x.h)

See also

PEP_KERNEL_INFORMATION_STRUCT_V3