структура D3COLD_AUX_POWER_AND_TIMING_INTERFACE (wdm.h)

Статья
03/05/2024

Расширенная версия структуры INTERFACE, которая позволяет драйверам устройств согласовывать более высокую вспомогательную мощность для своих устройств PCI в состоянии D3Cold. Этот интерфейс позволяет драйверам устройств вызывать функции, которые управляют _DSM функциями 0Ah, 0Bh.

Синтаксис

typedef struct _D3COLD_AUX_POWER_AND_TIMING_INTERFACE {
  USHORT                          Size;
  USHORT                          Version;
  PVOID                           Context;
  PINTERFACE_REFERENCE            InterfaceReference;
  PINTERFACE_DEREFERENCE          InterfaceDereference;
  PD3COLD_REQUEST_CORE_POWER_RAIL RequestCorePowerRail;
  PD3COLD_REQUEST_AUX_POWER       RequestAuxPower;
  PD3COLD_REQUEST_PERST_DELAY     RequestPerstDelay;
} D3COLD_AUX_POWER_AND_TIMING_INTERFACE, *PD3COLD_AUX_POWER_AND_TIMING_INTERFACE;

Члены

Size

Размер данной структуры (в байтах).

Version

Версия интерфейса, определяемого драйвером. Текущая версия этого интерфейса D3COLD_AUX_POWER_AND_TIMING_INTERFACE_VERSION.

Context

Указатель на сведения о контексте для конкретного интерфейса.

InterfaceReference

Указатель на подпрограмму InterfaceReference , которая увеличивает число ссылок интерфейса.

InterfaceDereference

Указатель на подпрограмму InterfaceDereference , которая уменьшает количество ссылок интерфейса.

RequestCorePowerRail

Указатель на функцию обратного вызова D3COLD_REQUEST_CORE_POWER_RAIL, которая позволяет объекту устройства-функции (FDO) указать, требуется ли базовая шина питания.

RequestAuxPower

Указатель на функцию обратного вызова _D3COLD_REQUEST_AUX_POWER , которая позволяет объекту устройства-функции передавать свои вспомогательные требования к энергопотреблению.

RequestPerstDelay

Указатель на D3COLD_REQUEST_PERST_DELAY позволяет объекту устройства-функции передать свое требование для фиксированного времени задержки.

Драйвер устройства, который успешно запрашивает интерфейс GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE, получает указатель на структуру [D3COLD_AUX_POWER_AND_TIMING_INTERFACE], в которой указатели на подпрограммы в интерфейсе не имеют значения NULL и являются допустимыми.

Структура [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] является расширенной версией структуры [INTERFACE].

Windows теперь добавила поддержку новых функций конкретного метода PCI Device Specific Method (_DSM) для управления питанием устройств среды выполнения. Новые интерфейсы, перечисленные ниже, позволяют драйверам устройств согласовывать более высокую вспомогательную мощность для своих устройств PCI (выше, чем стандартный 375 мА @ 3,3 В), если их устройства требуют дополнительного питания в состоянии D3Cold. Все драйверы устройств должны иметь возможность обрабатывать случаи, когда система не может предоставить дополнительную мощность или если интерфейсы не поддерживаются.

Все порты PCIe, поддерживающие функции _DSM для управления питанием устройств среды выполнения, должны реализовывать данные для конкретных устройств (_DSD) для определения портов PCIe, поддерживающих D3_COLD_AUX_POWER интерфейс ECN в область ACPI порта PCIe.