DXGKDDIPOWERRUNTIMECONTROLREQUEST callback function

Called by the Power Engine Plug-in (PEP) to exchange information with the display miniport driver. Also called by the Microsoft DirectX graphics kernel subsystem to notify the display miniport driver about certain events.

Syntax

DXGKDDIPOWERRUNTIMECONTROLREQUEST Dxgkddipowerruntimecontrolrequest;

NTSTATUS Dxgkddipowerruntimecontrolrequest(
  IN_CONST_HANDLE DriverContext,
  IN LPCGUID PowerControlCode,
  IN PVOID InBuffer,
  IN SIZE_T InBufferSize,
  OUT PVOID OutBuffer,
  IN SIZE_T OutBufferSize,
  OUT PSIZE_T BytesReturned
)
{...}

Parameters

DriverContext

A handle to a context block associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.

PowerControlCode

A pointer to a GUID that defines the meaning of the PEP's control request. For more information, see Remarks.

InBuffer

An optional pointer to an input buffer.

InBufferSize

The size, in bytes, of the buffer that InBuffer points to.

OutBuffer

An optional pointer to an output buffer.

OutBufferSize

The size, in bytes, of the buffer that OutBuffer points to.

BytesReturned

An optional pointer to a buffer that contains the number of bytes that are written by the display miniport driver to the output buffer.

Return Value

Returns STATUS_SUCCESS if it succeeds. Otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

The operating system calls DxgkDdiPowerRuntimeControlRequest only if the display miniport driver indicates support by setting DXGK_DRIVERCAPS.SupportRuntimePowerManagement to TRUE.

GUIDs used by the Power Engine Plugin (PEP)

The PEP uses the following GUIDs that are defined in D3dkmddi.h to exchange information with the display miniport driver. The display port driver uses these GUIDs to issue Event Tracing for Windows (ETW) events, which are useful to profile driver performance issues.
GUID_DXGKDDI_POWER_VOLTAGE_UP
Increase the voltage.
GUID_DXGKDDI_POWER_VOLTAGE_DOWN
Decrease the voltage.
GUID_DXGKDDI_POWER_VOLTAGE
Change the voltage, but the driver doesn't know if the change is an increase or decrease.
GUID_DXGKDDI_POWER_CLOCK_UP
Increase the clock setting.
GUID_DXGKDDI_POWER_CLOCK_DOWN
Decrease the clock setting.
GUID_DXGKDDI_POWER_CLOCK
Change the clock setting, but the driver doesn't know if the change is an increase or decrease.
GUID_DXGKDDI_POWER_BANDWIDTH_UP
Increase the bandwidth.
GUID_DXGKDDI_POWER_BANDWIDTH_DOWN
Decrease the bandwidth.
GUID_DXGKDDI_POWER_BANDWIDTH
Change the bandwidth, but the driver doesn't know if the change is an increase or decrease.

GUIDs used by the DirectX graphics kernel subsystem

The DirectX graphics kernel subsystem uses the following GUIDs that are defined in D3dkmddi.h to notify the display miniport driver about certain events.
GUID_DXGKDDI_POWER_MANAGEMENT_PREPARE_TO_START
Used after the DirectX graphics kernel subsystem registers the device for runtime power management, but before the device is started. After this function has been called with this GUID, the display miniport driver can call these functions:
GUID_DXGKDDI_POWER_MANAGEMENT_STARTED
Used after the DirectX graphics kernel subsystem starts runtime power management. After this function has been called with this GUID, the display miniport driver can call any power runtime functions.
GUID_DXGKDDI_POWER_MANAGEMENT_STOPPED
Used immediately before the DirectX graphics kernel subsystem unregisters the device for runtime power management. After this function has been called with this GUID, the display miniport driver should not call any power runtime functions.

Synchronization

This function can be called simultaneously from multiple execution threads.

The operating system guarantees that this function follows the zero level synchronization mode as defined in Threading and Synchronization Zero Level.

Requirements

   
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3dkmddi.h (include D3dkmddi.h)
IRQL <=DISPATCH_LEVEL

See Also

DXGKARG_QUERYADAPTERINFO

DXGK_DRIVERCAPS

DxgkCbSetPowerComponentActive

DxgkCbSetPowerComponentLatency

DxgkCbSetPowerComponentResidency

DxgkDdiAddDevice