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