функция обратного вызова 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 .
Возвращаемое значение
None
Remarks
Во время регистрации компонента драйвер мини-порта дисплея должен указать все компоненты питания, для которых ему потребуется вызвать функцию 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 (включая D3dkmddi.h) |
IRQL | <=DISPATCH_LEVEL |