Функция обратного вызова DXGKDDISETPOWERCOMPONENTFSTATE (d3dkmddi.h)

Статья
08/07/2023

Вызывается подсистемой ядра графики Microsoft DirectX для перевода компонента питания в состояние простоя (F-состояние).

Синтаксис

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

Параметры

DriverContext

Дескриптор для блока контекста, связанного с видеоадаптером. Функция DxgkDdiAdddDevice драйвера мини-порта дисплея ранее предоставляла этот дескриптор подсистеме ядра графики DirectX.

ComponentIndex

Индекс компонента питания, заданный DXGKARG_QUERYADAPTERINFO. pInputData в вызове функции DxgkDdiQueryAdapterInfo .

FState

Значение F-состояния, которое драйвер мини-порта дисплея передал подсистеме ядра графики DirectX.

Возвращаемое значение

Возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается STATUS_INVALID_PARAMETER.

Операционная система вызывает DxgkDdiSetPowerComponentFState , только если драйвер мини-порта дисплея указывает на поддержку, задав DXGK_DRIVERCAPS. Значение SupportRuntimePowerManagement — TRUE.

Примечание Чтобы избежать возможной взаимоблокировки, не вызывайте функцию DxgkCbSetPowerComponentActive , пока эта функция не будет возвращена.

Когда драйвер минипорта дисплея переводит компонент питания из состояния F0 (полностью включен) в другое F-состояние, он должен сохранить контекст, необходимый для последующего восстановления компонента в состояние F0.

Платформа управления питанием переводит компонент только в состояние F0 или из нее.

Эту функцию можно вызывать одновременно из нескольких потоков выполнения. Однако только один поток за раз может вызывать эту функцию для управления определенным компонентом.

Операционная система гарантирует, что эта функция соответствует режиму синхронизации нулевого уровня, как определено в разделе Потоки и синхронизация нулевого уровня.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL