функция обратного вызова DXGKCB_SETPOWERCOMPONENTRESIDENCY (d3dkmddi.h)
Драйвер мини-порта в режиме ядра вызывает DXGKCB_SETPOWERCOMPONENTRESIDENCY, чтобы задать ожидаемое место расположения для компонента питания типа DXGK_POWER_COMPONENT_OTHER.
Синтаксис
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
Параметры
[in] hAdapter
Дескриптор адаптера отображения. Драйвер минипорта отображения получает дескриптор от элемента DeviceHandle структуры DXGKRNL_INTERFACE в вызове функции DxgkDdiStartDevice.
[in] ComponentIndex
Индекс компонента питания, указанный DXGKARG_QUERYADAPTERINFO.pInputData в вызове функции DxgkDdiQueryAdapterInfo.
[in] Residency
Ожидаемое место расположения — максимальное время в единицах 100 наносекунд , что драйвер минипорта отображения ожидает, что компонент питания останется бездействующим после ввода состояния простоя. Power Management Framework использует эти сведения для выбора соответствующего состояния простоя для компонента, который не нарушает запрошенное место проживания. Ожидаемое место проживания, указанное резиденции, остается в силе, пока драйвер снова не вызовет эту функцию, чтобы обновить ее. См. примечания.
Возвращаемое значение
Никакой
Замечания
Заметка
Драйвер минипорта отображения должен вызывать эту функцию, только если тип компонента DXGK_POWER_COMPONENT_OTHER. Подсистема ядра графики DirectX задает ожидаемое значение расположения для других типов компонентов.
DXGKCB_XXX функции реализуются Dxgkrnl. Чтобы использовать эту функцию обратного вызова, вызовите DxgkCbSetPowerComponentResidency через DXGKRNL_INTERFACE.
Если компонент питания находится в состоянии простоя при вызове этой функции, Power Management Framework может изменить состояние F компонента на соответствие ожидаемому значению расположения, заданному резиденции.
Если драйвер задает значение PO_FX_UNKNOWN_TIME (определено в Wdm.h), подключаемый модуль Power Engine (PEP) может не иметь возможности задать для компонента состояние F меньше F0.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 8 (WDDM 1.2) |
| минимальный поддерживаемый сервер | Windows Server 2012 |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | <= DISPATCH_LEVEL |