PDXGK_POWER_NOTIFICATION fonction de rappel (d3dkmthk.h)

Article
02/23/2024

Rappel indiquant que l’appareil graphique va faire l’objet d’une transition d’état d’alimentation de l’appareil.

Syntaxe

PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;

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

Paramètres

GraphicsDeviceHandle

Un handle opaque qui doit être fourni lors des rappels au périphérique graphique.

NewGrfxPowerState

Valeur DEVICE_POWER_STATE qui indique le nouvel état d’alimentation graphique en cours de définition.

PreNotification

Valeur booléenne qui indique si une notification doit être fournie.

PrivateHandle

Handle opaque fourni dans tous les rappels. Ce handle doit être globalement unique. Par conséquent, un pointeur vers l’AOP ou le FDO du pilote appelant doit être utilisé.

Valeur de retour

None

Remarques

Ce rappel est effectué à PASSIVE_LEVEL. Le pilote peut se bloquer pour terminer la maintenance de l’opération uniquement lorsque le nouvel état d’alimentation est PowerDeviceD3. Dans ce cas, l’appel doit toujours être effectué en temps opportun, car il peut bloquer la fin de la transition de l’état d’alimentation global de l’appareil et est susceptible de provoquer un bogue de surveillance de l’alimentation case activée. Le pilote ne doit pas bloquer lorsque le nouvel état est PowerDeviceD0. Lorsque vous accédez à PowerDeviceD3, une notification « pré » et « post » sera fournie, en supposant que la transition n’est pas annulée dans l’intervalle. Lorsque vous accédez à PowerDeviceD0, seule une notification « post » est fournie. Ce gestionnaire de rappel peut appeler le rappel graphique SetSharedPowerComponentStateCb si vous le souhaitez ; aucun autre rappel dans le noyau graphique n’est autorisé à partir de ce gestionnaire.

Important

L’état d’alimentation graphique initial sera fourni dans la sortie IOCTL. Toutefois, étant donné qu’il est possible que le périphérique graphique subit une transition d’état d’alimentation pendant l’inscription, un mutex doit être acquis autour de l’appel IOCTL et de l’analyse de l’état d’origine, et ce même mutex doit être acquis dans cette fonction de rappel. De cette façon, si l’état est en cours de transition, le rappel fournit les informations d’état les plus à jour.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	d3dkmthk.h
IRQL	<= PASSIVE_LEVEL

Voir aussi

DEVICE_POWER_STATE

Partager via