DxgkDdiSetPowerPState routine

Article
06/19/2013

[This documentation is preliminary and is subject to change.]

Called by the Microsoft DirectX graphics kernel subsystem to transition a power component to a new P-state active power state.

Syntax

PDXGKDDISETPOWERPSTATE DxgkDdiSetPowerPState;

NTSTATUS APIENTRY DxgkDdiSetPowerPState(
  _In_  const HANDLE DriverContext,
  _In_  UINT ComponentIndex,
  _In_  UINT RequestedComponentPState
)
{ ... }

Parameters

DriverContext [in]
A handle to a context block associated with a display adapter that is making the request to transition to a new P-state. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.
ComponentIndex [in]
The power component index specified by DXGKARG_QUERYADAPTERINFO.pInputData in a call to the DxgkDdiQueryAdapterInfo function.
RequestedComponentPState [in]
A UINT value that represents the P-state to which the power component should be set.

Return value

DxgkDdiSetPowerPState should never fail; however, it can return any NTSTATUS-typed value that is defined in Ntstatus.h and that passes the NT_SUCCESS(Status) macro, including:

Return code	Description
STATUS_SUCCESS	The P-state transition occurred synchronously with the call to this function.
STATUS_PENDING	The P-state transition was successfully initiated. This means that the component voted to transition to the specified P-state, even if ultimately the component doesn't end up completing the transition due to limitations such as shared power relationships or thermal limits.

Remarks

For more info on how to manage P-states, see Power management using P-states.

To achieve a faster transition, some hardware can initiate a new DxgkDdiSetPowerPState-requested P-state before a prior request has been completed.

Requirements

Minimum supported client	Windows 8.1 Preview
Minimum supported server	Windows Server 2012 R2 Preview
Header	D3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Share via