DXGKDDI_NOTIFY_ACPI_EVENT fonction de rappel (dispmprt.h)

Article
05/23/2024

Avertit le pilote de 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 d’un bloc de contexte qui représente une carte d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait précédemment cette poignée 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 le raccourci clavier d’affichage du cycle. ACPI_NOTIFY_DOCK_EVENT : indique qu’un événement d’ancrage s’est produit. Par exemple, l’utilisateur a ancré ou débarqué un ordinateur mobile. ACPI_NOTIFY_DEVICE_HOTPLUG : indique que le status de tout périphérique de sortie attaché au contrôleur VGA a été modifié. Par exemple, l’utilisateur a supprimé ou branché un écran CRT au port VGA. ACPI_NOTIFY_PANEL_SWITCH : indique que le status de l’un des périphériques de sortie attachés au contrôleur VGA a été activé. Par exemple, l’utilisateur a basculé l’affichage de sortie actif de l’écran LCD vers le type d’affichage CRT. ACPI_NOTIFY_VIDEO_WAKEUP : indique que l’affichage de sortie a 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ébarqué 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, cette valeur est NULL. Le tableau suivant montre les arguments d’événement, qui sont des valeurs ULONG, pour les numéros 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 alimentation secteur.
PO_CB_LID_SWITCH_STATE	0 : indique que le couvercle est en cours de fermeture. 1 - Indique que le couvercle est en cours d’ouverture.

[out] AcpiFlags

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

Valeur	Type de demande
DXGK_ACPI_CHANGE_DISPLAY_MODE	Le pilote miniport d’affichage demande au système d’exploitation d’appeler la fonction DxgkDdiRecommendFunctionalVidPn , puis d’initier un changement de mode vers le nouveau réseau VidPN (Active Video Present Network) recommandé. Par exemple, le pilote miniport d’affichage peut effectuer cette demande si l’utilisateur a spécifié un changement de mode.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN	Le pilote miniport d’affichage envoie une demande au système d’exploitation pour 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 l’alimentation.

Valeur retournée

DxgkDdiNotifyAcpiEvent retourne STATUS_SUCCESS si elle réussit ; sinon, il 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dispmprt.h
IRQL	PASSIVE_LEVEL

Voir aussi

DxgkCbEvalAcpiMethod

Partager via