функция обратного вызова PDXGK_FSTATE_NOTIFICATION (d3dkmthk.h)

Статья
03/08/2023

Реализуется драйвером клиента для отправки уведомления о состоянии.

Синтаксис

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

void PdxgkFstateNotification(
  PVOID GraphicsDeviceHandle,
  ULONG ComponentIndex,
  UINT NewFState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

Параметры

GraphicsDeviceHandle

Непрозрачный дескриптор, который должен быть указан при выполнении обратных вызовов графического устройства.

ComponentIndex

Индекс компонента. Как правило, это индекс, используемый графическим адаптером. Исключением являются сценарии LDA, где HIWORD componentIndex указывает индекс адаптера, как это делается при вызове графического драйвера графическим ядром для изменения F-состояния в сценариях LDA.

NewFState

F-состояние для перехода.

PreNotification

Указывает, что должно быть предоставлено уведомление.

PrivateHandle

Непрозрачный дескриптор, который будет предоставляться в любых обратных вызовах. Этот дескриптор должен быть глобально уникальным, поэтому следует использовать указатель на PDO или FDO вызывающего драйвера.

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

None

Remarks

Все обратные вызовы, выполненные из Dxgkrnl в этот обратный вызов, могут вызываться в DISPATCH_LEVEL (например, не графический драйвер не должен блокировать ни одно из этих уведомлений). Обратные вызовы будут выполняться только для компонентов питания типа DXGK_POWER_COMPONENT_SHARED .

Перед переходом F-состояний будут предоставлены предварительные уведомления. Обратные вызовы уведомления о завершении (PreNotification==FALSE) выдаются как часть обратного вызова DxgkCbCompleteFStateTransition графического драйвера. То есть все общие компоненты питания будут уведомлены о завершении перехода f-состояния до возврата DxgkCbCompleteFStateTransition.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Верхняя часть	d3dkmthk.h
IRQL	<= DISPATCH_LEVEL