DXGKDDI_NOTIFY_ACPI_EVENT fonction de rappel (dispmprt.h)

Article
02/06/2025

Avertit le pilote miniport d’affichage de certains événements ACPI.

Syntaxe

DXGKDDI_NOTIFY_ACPI_EVENT DxgkddiNotifyAcpiEvent;

NTSTATUS DxgkddiNotifyAcpiEvent(
  [in]  IN_CONST_PVOID MiniportDeviceContext,
  [in]  IN_DXGK_EVENT_TYPE EventType,
  [in]  IN_ULONG Event,
  [in]  IN_PVOID Argument,
  [out] OUT_PULONG AcpiFlags
)
{...}

Paramètres

[in] MiniportDeviceContext

Handle vers un bloc de contexte qui représente un adaptateur d’affichage. La fonction d’affichage du pilote miniport DxgkDdiAddDevice précédemment fourni ce handle au sous-système du noyau graphique DirectX.

[in] EventType

Énumérateur DXGK_EVENT_TYPE qui fournit le type d’événement (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).

[in] Event

Numéro d’événement. Le tableau suivant répertorie les numéros d’événements possibles pour chacun des types d’événements.

Type d’événement	Numéros d’événements possibles
DpAcpiEvent	Voici les événements autorisés tels que définis dans Dispmprt.h : ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY : il avertit le système d’exploitation que l’utilisateur a appuyé sur la touche d’accès rapide du cycle. ACPI_NOTIFY_DOCK_EVENT : indique qu’un événement d’ancrage s’est produit. Par exemple, l’utilisateur a ancré ou décompressé un ordinateur mobile. ACPI_NOTIFY_DEVICE_HOTPLUG : indique que l’état d’un périphérique de sortie attaché au contrôleur VGA a été modifié. Par exemple, l’utilisateur a supprimé ou branché un affichage CRT sur le port UDP. ACPI_NOTIFY_PANEL_SWITCH : indique que l’état de l’un des périphériques de sortie attachés au contrôleur VGA a été désactivé. Par exemple, l’utilisateur a basculé l’affichage de sortie active de LCD vers le type d’affichage CRT. ACPI_NOTIFY_VIDEO_WAKEUP : indique que l’affichage de sortie a été repris. Par exemple, l’utilisateur a réactivé l’affichage de l’ordinateur.
DpPowerStateEvent	PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS Défini dans Wdm.h.
DpDockingEvent	ACPI_NOTIFY_DOCK_EVENT : indique qu’un événement d’ancrage s’est produit. Par exemple, l’utilisateur a ancré ou décompressé un ordinateur mobile. Défini dans Dispmprt.h.

[in] Argument

Pointeur vers un argument qui dépend de l’événement. Pour la plupart des événements, ce sera NULL. Le tableau suivant présente les arguments d’événement, qui sont des valeurs ULONG, pour les nombres d’événements spécifiés disponibles.

Numéro d’événement	Arguments d’événement possibles
PO_CB_AC_STATUS	0 - Indique que le système est sur batterie. 1 - Indique que le système est sur l’alimentation ac.
PO_CB_LID_SWITCH_STATE	0 - Indique que le couvercle est fermé. 1 - Indique que le couvercle est ouvert.

[out] AcpiFlags

Pointeur vers une valeur qui indique le type de requête que le pilote miniport d’affichage doit effectuer vers le système d’exploitation. Le tableau suivant montre les valeurs qui peuvent être spécifiées.

valeur	type de requête
DXGK_ACPI_CHANGE_DISPLAY_MODE	Le pilote display miniport envoie une demande au système d’exploitation pour appeler la fonction DxgkDdiRecommendFunctionalVidPn, puis pour lancer une modification du mode vers le nouveau réseau vidéo actif recommandé (VidPN). Par exemple, le pilote miniport d’affichage peut effectuer cette requête si l’utilisateur a spécifié une modification de mode.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN	Le pilote miniport d’affichage demande au système d’exploitation d’interroger la connectivité des enfants de l’adaptateur d’affichage représenté par MiniportDeviceContext.
DXGK_ACPI_CHAIN_NOT_HANDLED	Indique qu’un événement de type DxgkChainedAcpiEvent n’a pas été géré par le pilote discret hybride et doit donc être envoyé au pilote intégré hybride.

Ce paramètre est ignoré si cette fonction retourne une erreur ou si l’adaptateur d’affichage perd de la puissance.

Valeur de retour

DxgkDdiNotifyAcpiEvent retourne STATUS_SUCCESS s’il réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

DxgkDdiNotifyAcpiEvent est une fonction de pilote miniport d’affichage facultative.

DxgkDdiNotifyAcpiEvent doit être rendu paginable.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Bureau
d’en-tête	dispmprt.h
IRQL	PASSIVE_LEVEL

Voir aussi

DxgkCbEvalAcpiMethod

Partager via