функция обратного вызова 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

См. также раздел

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE