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

Статья
02/06/2025

Обратный вызов, предоставляющий уведомление о том, что графическое устройство будет проходить переход состояния питания устройства.

Синтаксис

PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;

void PdxgkPowerNotification(
  PVOID GraphicsDeviceHandle,
  DEVICE_POWER_STATE NewGrfxPowerState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

Параметры

GraphicsDeviceHandle

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

NewGrfxPowerState

Значение DEVICE_POWER_STATE, указывающее новое графическое состояние питания, которое находится в процессе установки.

PreNotification

Логическое значение, указывающее, следует ли предоставлять уведомление.

PrivateHandle

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

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

Никакой

Замечания

Обратный вызов выполняется по PASSIVE_LEVEL. Драйвер может заблокировать обслуживание операции только в том случае, если новое состояние питания — PowerDeviceD3. В этом случае вызов по-прежнему должен быть выполнен своевременно, так как он может блокировать завершение общего перехода состояния питания устройства и вызывает проверку ошибок системы наблюдения за питанием. Драйвер не должен блокироваться, если новое состояние — PowerDeviceD0. При переходе в PowerDeviceD3 будет предоставлено уведомление "pre" и "post", если переход не отменен в промежуточном периоде. При входе в PowerDeviceD0 будет предоставлено только уведомление "post". При необходимости этот обработчик обратного вызова может вызывать графический обратный вызов SetSharedPowerComponentStateCb; другие обратные вызовы в графическое ядро не допускаются из этого обработчика.

Важный

Исходное состояние питания графики будет предоставлено в выходных данных IOCTL, так как возможно, что графическое устройство может пройти переход состояния питания во время регистрации, мьютекс должен быть получен вокруг вызова IOCTL и синтаксического анализа исходного состояния, и тот же мьютекс должен быть получен в этой функции обратного вызова. Таким образом, если состояние будет переходить, обратный вызов предоставит самые актуальные сведения о состоянии.

Требования

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

См. также

DEVICE_POWER_STATE

Поделиться через