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

  • Статья

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

Синтаксис

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 вызывающего драйвера.

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

None

Remarks

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

Важно!

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

Требования

Требование Значение
Минимальная версия клиента Windows 8
Минимальная версия сервера Windows Server 2012
Целевая платформа Windows
Header d3dkmthk.h
IRQL <= PASSIVE_LEVEL

См. также раздел

DEVICE_POWER_STATE