D3COLD_REQUEST_CORE_POWER_RAIL callback function

Enables the function device object (FDO) to indicate whether the core power rail is needed.

Syntax

D3COLD_REQUEST_CORE_POWER_RAIL D3coldRequestCorePowerRail;

void D3coldRequestCorePowerRail(
  PVOID Context,
  BOOLEAN CorePowerRailNeeded
)
{...}

Parameters

Context

[In_reads_opt(Inexpressible("varies"))] The handle to the device.

CorePowerRailNeeded

Return Value

None

Remarks

A device driver that successfully queries for the GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE interface receives a pointer to a D3COLD_AUX_POWER_AND_TIMING_INTERFACE structure in which the driver sets the RequestCorePowerRail member to a pointer to its implementation of the D3COLD_REQUEST_CORE_POWER_RAIL callback function.

  • If the driver indicates that the core power rail is needed, it is guaranteed that the core power rail is turned on when this call returns.

  • When a driver indicates that the core power rail is no longer needed, there is no guarantee of the core power rail state onwards.

  • This routine can never fail.

Requirements

   
Minimum supported client Windows 10, version 1803
Header wdm.h