функция обратного вызова DXGKCB_SETPOWERCOMPONENTIDLE (d3dkmddi.h)
Драйвер мини-порта дисплея вызывает DXGKCB_SETPOWERCOMPONENTIDLE для уведомления подсистемы ядра графики DirectX о том, что компонент питания больше не нужен. После возврата этой функции драйвер мини-порта дисплея не должен изменять параметры оборудования компонента.
Синтаксис
DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;
void DxgkcbSetpowercomponentidle(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex
)
{...}
Параметры
[in] hAdapter
Дескриптор адаптера отображения. Драйвер минипорта отображения получает дескриптор от элемента DeviceHandle структуры DXGKRNL_INTERFACE в вызове функции DxgkDdiStartDevice.
[in] ComponentIndex
Индекс компонента питания, указанный DXGKARG_QUERYADAPTERINFO.pInputData в вызове функции DxgkDdiQueryAdapterInfo.
Возвращаемое значение
Никакой
Замечания
Драйвер минипорта отображения может вызывать эту функцию для любого типа компонента питания, даже если подсистема графического ядра DirectX управляет состоянием простоя компонента.
DXGKCB_XXX функции реализуются Dxgkrnl. Чтобы использовать эту функцию обратного вызова, вызовите DxgkCbSetPowerComponentIdle через DXGKRNL_INTERFACE. Каждый вызов этой функции должен быть связан с вызовом функции DXGKCB_SETPOWERCOMPONENTACTIVE.
При вызове этой функции активное число ссылок компонента уменьшается на 1. Power Management Framework поддерживает количество ссылок и помещает компонент в более низкое состояние F, только если число ссылок становится нулевым.
Эта функция должна вызываться в IRQL <= DISPATCH_LEVEL. Его можно вызывать в IRQL = DISPATCH_LEVEL только в том случае, если тип компонента DXGK_POWER_COMPONENT_OTHER.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 8 (WDDM 1.2) |
| минимальный поддерживаемый сервер | Windows Server 2012 |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | См. раздел "Примечания". |