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

Статья
02/06/2025

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

Синтаксис

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

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

Параметры

DriverContext

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

ComponentIndex

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

FState

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

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

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

Замечания

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

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

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

Power Management Framework переходит только к компоненту или из состояния F0.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Настольный
заголовка	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL