PDXGK_POWER_NOTIFICATION función de devolución de llamada (d3dkmthk.h)

Devolución de llamada que proporciona una notificación de que el dispositivo gráfico estará realizando una transición de estado de energía del dispositivo.

Sintaxis

PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;

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

Parámetros

GraphicsDeviceHandle

Identificador opaco que se debe proporcionar al realizar devoluciones de llamada en el dispositivo gráfico.

NewGrfxPowerState

Valor DEVICE_POWER_STATE que indica el nuevo estado de potencia de gráficos que está en proceso de establecimiento.

PreNotification

Valor booleano que indica si se debe proporcionar una notificación.

PrivateHandle

Un identificador opaco proporcionado en las devoluciones de llamada. Este identificador debe ser único globalmente, por lo tanto, se debe usar un puntero al PDO o FDO del controlador de llamada.

Valor devuelto

Ninguno

Observaciones

Esta devolución de llamada se realiza en PASSIVE_LEVEL. El controlador puede bloquearse para completar el mantenimiento de la operación solo cuando el nuevo estado de energía es PowerDeviceD3. En este caso, la llamada todavía debe completarse de forma oportuna, ya que puede bloquear la finalización de la transición general del estado de energía del dispositivo y está sujeta a la causa de una comprobación de errores del guardián de energía. El controlador no debe bloquearse cuando el nuevo estado es PowerDeviceD0. Al entrar en PowerDeviceD3, se proporcionará una notificación "pre" y "post", suponiendo que la transición no se cancele mientras tanto. Al entrar en PowerDeviceD0, solo se proporcionará una notificación "post". Se permite que este controlador de devolución de llamada llame a la devolución de llamada de gráficos SetSharedPowerComponentStateCb si lo desea; no se permiten otras devoluciones de llamada en el kernel de gráficos desde este controlador.

Importante

Sin embargo, el estado inicial de energía de gráficos se proporcionará en la salida del IOCTL, ya que es posible que el dispositivo gráfico esté experimentando una transición de estado de energía mientras se está produciendo el registro, se debe adquirir una exclusión mutua alrededor de la llamada IOCTL y el análisis del estado original, y esa misma exclusión mutua debe adquirirse en esta función de devolución de llamada. De este modo, si el estado está realizando la transición, la devolución de llamada proporcionará la información de estado más actualizada.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8
servidor mínimo admitido	Windows Server 2012
de la plataforma de destino de	Windows
encabezado de	d3dkmthk.h
irQL	<= PASSIVE_LEVEL

Consulte también

DEVICE_POWER_STATE