Skip to content

Latest commit

 

History

History
102 lines (70 loc) · 4.69 KB

ns-wdm-_d3cold_aux_power_and_timing_interface.md

File metadata and controls

102 lines (70 loc) · 4.69 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.ddi-compliance req.unicode-ansi req.max-support req.typenames targetos f1_keywords topic_type api_type api_location api_name
NS:wdm._D3COLD_AUX_POWER_AND_TIMING_INTERFACE
_D3COLD_AUX_POWER_AND_TIMING_INTERFACE (wdm.h)
Allows device drivers to negotiate a higher auxiliary power for their PCI devices while in D3Cold state.
kernel
10/19/2018
D3COLD_AUX_POWER_AND_TIMING_INTERFACE structure
_D3COLD_AUX_POWER_AND_TIMING_INTERFACE, *PD3COLD_AUX_POWER_AND_TIMING_INTERFACE, D3COLD_AUX_POWER_AND_TIMING_INTERFACE,
wdm.h
Windows 10, version 1803
D3COLD_AUX_POWER_AND_TIMING_INTERFACE, *PD3COLD_AUX_POWER_AND_TIMING_INTERFACE
Windows
_D3COLD_AUX_POWER_AND_TIMING_INTERFACE
wdm/_D3COLD_AUX_POWER_AND_TIMING_INTERFACE
PD3COLD_AUX_POWER_AND_TIMING_INTERFACE
wdm/PD3COLD_AUX_POWER_AND_TIMING_INTERFACE
D3COLD_AUX_POWER_AND_TIMING_INTERFACE
wdm/D3COLD_AUX_POWER_AND_TIMING_INTERFACE
apiref
HeaderDef
wdm.h
_D3COLD_AUX_POWER_AND_TIMING_INTERFACE
PD3COLD_AUX_POWER_AND_TIMING_INTERFACE
D3COLD_AUX_POWER_AND_TIMING_INTERFACE

_D3COLD_AUX_POWER_AND_TIMING_INTERFACE structure

-description

An extended version of the INTERFACE structure that allows device drivers to negotiate a higher auxiliary power for their PCI devices while in D3Cold state. This interface allows device drivers to invoke the functions that manipulate _DSM functions 0Ah, 0Bh.

-struct-fields

-field Size

The size, in bytes, of this structure.

-field Version

The driver-defined interface version. The current version of this interface is D3COLD_AUX_POWER_AND_TIMING_INTERFACE_VERSION.

-field Context

A pointer to interface-specific context information.

-field InterfaceReference

A pointer to an InterfaceReference routine that increments the interface's reference count.

-field InterfaceDereference

A pointer to an InterfaceDereference routine that decrements the interface's reference count.

-field RequestCorePowerRail

A pointer to a D3COLD_REQUEST_CORE_POWER_RAIL callback function that enables the function device object (FDO) to indicate whether the core power rail is needed.

-field RequestAuxPower

A pointer to a _D3COLD_REQUEST_AUX_POWER callback function that enables the function device object (FDO) to convey its auxiliary power requirement.

-field RequestPerstDelay

A pointer to a D3COLD_REQUEST_PERST_DELAY enables the function device object (FDO) to convey its requirement for a fixed delay time.

-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 pointers to the routines in the interface are all non-NULL and valid.

The [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] structure is an extended version of the [INTERFACE] structure.

Windows now has added support for the newly introduced PCI Device Specific Method (_DSM) functions for Runtime Device Power Management. The new interfaces listed below allow device drivers to negotiate a higher auxiliary power for their PCI devices (higher than the standard 375mA @ 3.3V), if their devices require additional power while in D3Cold state. All device drivers must be able to handle the cases where additional power cannot be provided by the system, or if the interfaces are not supported.

All PCIe ports that support the _DSM functions for Runtime Device Power Management, must implement the Device Specific Data (_DSD) for Identifying PCIe ports supporting D3_COLD_AUX_POWER ECN Interface under the ACPI scope of the PCIe port.

-see-also

_D3COLD_REQUEST_CORE_POWER_RAIL

_D3COLD_REQUEST_AUX_POWER

_D3COLD_REQUEST_PERST_DELAY

Identifying PCIe ports supporting D3_COLD_AUX_POWER ECN Interface