D3COLD_REQUEST_CORE_POWER_RAIL callback function (wdm.h)

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

Syntax

D3COLD_REQUEST_CORE_POWER_RAIL D3coldRequestCorePowerRail;

void D3coldRequestCorePowerRail(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      BOOLEAN CorePowerRailNeeded
)
{...}

Parameters

Context

The handle to the device.

[_In_] CorePowerRailNeeded

A flag that indicates whether or not the driver needs the core power rail.

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

Requirement Value
Minimum supported client Windows 10, version 1803
Header wdm.h (include Wdm.h)