DXGKDDI_NOTIFY_ACPI_EVENT Rückruffunktion (dispmprt.h)

Artikel
02/23/2024

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)	Windows Vista
Zielplattform	Desktop
Kopfzeile	dispmprt.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

DxgkCbEvalAcpiMethod

Freigeben über