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 alimentación 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 de DEVICE_POWER_STATE que indica el nuevo estado de potencia de gráficos que se encuentra en el proceso de establecimiento.
PreNotification
Valor booleano que indica si se debe proporcionar una notificación.
PrivateHandle
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 que realiza la llamada.
Valor devuelto
None
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 "anterior" y "posterior", 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 permite ninguna otra devolución de llamada en el kernel de gráficos desde este controlador.
Importante
Sin embargo, el estado de energía de gráficos inicial 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Windows |
| Encabezado | d3dkmthk.h |
| IRQL | <= PASSIVE_LEVEL |