DXGKDDI_NOTIFY_ACPI_EVENT fonction de rappel (dispmprt.h)

  • Article

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 pour un bloc de contexte qui représente un adaptateur d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage a 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 : avertit le système d’exploitation que l’utilisateur a appuyé sur la touche d’accès rapide de l’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 sur le 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é basculé. 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, il s’agit de NULL. Le tableau suivant présente 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 sous 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 demande que le pilote de miniport d’affichage doit effectuer au système d’exploitation. Le tableau suivant présente les valeurs qui peuvent être spécifiées.

Valeur Type de demande
DXGK_ACPI_CHANGE_DISPLAY_MODE Le pilote de 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 vidéo actif (VidPN) recommandé. Par exemple, le pilote de miniport d’affichage peut effectuer cette requête si l’utilisateur a spécifié un changement de mode.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN Le pilote de miniport d’affichage demande au système d’exploitation d’interroger la connectivité des enfants de la carte graphique représentée 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 la carte graphique perd l’alimentation.

Valeur retournée

DxgkDdiNotifyAcpiEvent retourne STATUS_SUCCESS si elle 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h
IRQL PASSIVE_LEVEL

Voir aussi

DxgkCbEvalAcpiMethod