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