PDXGK_POWER_NOTIFICATION fonction de rappel (d3dkmthk.h)

Rappel fournissant une notification indiquant que l’appareil graphique subira 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

Handle opaque qui doit être fourni lors de la création de rappels sur l’appareil graphique.

NewGrfxPowerState

Valeur DEVICE_POWER_STATE qui indique le nouvel état d’alimentation graphique qui se trouve dans le processus 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’objet PDO ou FDO du pilote appelant doit être utilisé.

Valeur de retour

Aucun

Remarques

Ce rappel est effectué à PASSIVE_LEVEL. Le pilote peut 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 voulu, car il peut bloquer l’achèvement de la transition globale de l’état de l’alimentation de l’appareil et est soumis à une vérification de bogue de l’agent de surveillance de l’alimentation. Le pilote ne doit pas bloquer lorsque le nouvel état est PowerDeviceD0. Lorsque vous passez à PowerDeviceD3, une notification « pré » et « post » est fournie, en supposant que la transition n’est pas annulée dans l’intervalle. Lorsque vous passez à PowerDeviceD0, seule une notification « post » est fournie. Ce gestionnaire de rappels est autorisé à 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 initial de l’alimentation graphique sera fourni dans la sortie IOCTL. Toutefois, étant donné que le périphérique graphique peut subir une transition d’état d’alimentation pendant que l’inscription se produit, un mutex doit être acquis autour de l’appel IOCTL et l’analyse de l’état d’origine, et que ce même mutex doit être acquis dans cette fonction de rappel. De cette façon, si l’état passe, le rappel fournit les informations d’état les plus à jour.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	d3dkmthk.h
IRQL	<= PASSIVE_LEVEL

Voir aussi

DEVICE_POWER_STATE