DXGKDDI_NOTIFY_ACPI_EVENT Rückruffunktion (dispmprt.h)

  • Artikel

Benachrichtigt den Display-Miniporttreiber über bestimmte ACPI-Ereignisse.

Syntax

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
)
{...}

Parameter

[in] MiniportDeviceContext

Ein Handle für einen Kontextblock, der eine Grafikkarte darstellt. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

[in] EventType

Ein DXGK_EVENT_TYPE Enumerator, der den Ereignistyp bereitstellt (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).

[in] Event

Die Ereignisnummer. In der folgenden Tabelle sind die möglichen Ereignisnummern für die einzelnen Ereignistypen aufgeführt.

Ereignistyp Mögliche Ereignisnummern
DpAcpiEvent Im Folgenden sind die zulässigen Ereignisse aufgeführt, wie in Dispmprt.h definiert:
  • ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY: Das Betriebssystem wird benachrichtigt, dass der Benutzer den Hotkey für die Zyklusanzeige gedrückt hat.
  • ACPI_NOTIFY_DOCK_EVENT: Gibt an, dass ein Andockereignis aufgetreten ist. Beispielsweise hat der Benutzer einen mobilen Computer angedockt oder abgedockt.
  • ACPI_NOTIFY_DEVICE_HOTPLUG: Gibt an, dass die status jedes Ausgabegeräts geändert wurde, das an den VGA-Controller angeschlossen ist. Beispielsweise hat der Benutzer eine CRT-Anzeige entfernt oder an den VGA-Anschluss angeschlossen.
  • ACPI_NOTIFY_PANEL_SWITCH: Gibt an, dass die status eines der Ausgabegeräte, die an den VGA-Controller angeschlossen sind, umgeschaltet wurde. Beispielsweise hat der Benutzer die aktive Ausgabeanzeige von LCD auf CRT-Anzeigetyp umgestellt.
  • ACPI_NOTIFY_VIDEO_WAKEUP: Gibt an, dass die Ausgabeanzeige fortgesetzt wurde. Beispielsweise hat der Benutzer die Computeranzeige reaktiviert.
DpPowerStateEvent PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS
Definiert in Wdm.h.
DpDockingEvent ACPI_NOTIFY_DOCK_EVENT: Gibt an, dass ein Andockereignis aufgetreten ist. Beispielsweise hat der Benutzer einen mobilen Computer angedockt oder abgedockt.
Definiert in Dispmprt.h.

[in] Argument

Ein Zeiger auf ein Argument, das vom Ereignis abhängt. Für die meisten Ereignisse ist dies NULL. Die folgende Tabelle zeigt die Ereignisargumente, bei denen es sich um ULONG-Werte handelt, für die angegebenen Ereignisnummern, die verfügbar sind.

Ereignisnummer Mögliche Ereignisargumente
PO_CB_AC_STATUS 0 – Gibt an, dass das System mit Akkubetrieb betrieben wird.
1 : Gibt an, dass das System mit Netzstrom versorgt ist.
PO_CB_LID_SWITCH_STATE 0 – Gibt an, dass der Deckel geschlossen wird.
1 – Gibt an, dass der Deckel geöffnet wird.

[out] AcpiFlags

Ein Zeiger auf einen Wert, der den Typ der Anforderung angibt, die der Anzeigeminiporttreiber an das Betriebssystem senden soll. In der folgenden Tabelle sind die Werte aufgeführt, die angegeben werden können.

Wert Anforderungstyp
DXGK_ACPI_CHANGE_DISPLAY_MODE Der Anzeige-Miniporttreiber sendet eine Anforderung an das Betriebssystem, die DxgkDdiRecommendFunctionalVidPn-Funktion aufzurufen und dann eine Modusänderung an das neue empfohlene aktive Video present Network (VidPN) zu initiieren. Beispielsweise kann der Anzeigeminiporttreiber diese Anforderung ausführen, wenn der Benutzer eine Modusänderung angegeben hat.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN Der Anzeige-Miniporttreiber sendet eine Anforderung an das Betriebssystem, um die Konnektivität der untergeordneten Elemente des durch MiniportDeviceContext dargestellten Displayadapters abzufragen.
DXGK_ACPI_CHAIN_NOT_HANDLED Gibt an, dass ein Ereignis vom Typ DxgkChainedAcpiEvent nicht vom diskreten Hybridtreiber verarbeitet wurde und daher an den integrierten Hybridtreiber gesendet werden soll.

Dieser Parameter wird ignoriert, wenn diese Funktion einen Fehler zurückgibt oder die Grafikkarte stromlos ist.

Rückgabewert

DxgkDdiNotifyAcpiEvent gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

DxgkDdiNotifyAcpiEvent ist eine optionale Anzeige-Miniporttreiberfunktion.

DxgkDdiNotifyAcpiEvent sollte als ausgelagert werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile dispmprt.h
IRQL PASSIVE_LEVEL

Weitere Informationen

DxgkCbEvalAcpiMethod