функция обратного вызова 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 (include D3dkmddi.h)
IRQL <=DISPATCH_LEVEL

См. также

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE