DXGKDDI_CONTROLINTERRUPT3 Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdi_ControlInterrupt3-Funktion aktiviert oder deaktiviert den angegebenen Interrupttyp für die angegebene VidPnSourceId auf der Grafikhardware.

Syntax

DXGKDDI_CONTROLINTERRUPT3 DxgkddiControlinterrupt3;

NTSTATUS DxgkddiControlinterrupt3(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_CONTROLINTERRUPT3 InterruptControl
)
{...}

Parameter

[in] hAdapter

Ein Handle für das Adapterobjekt für die Grafikverarbeitungseinheit (GPU). Der Treiber hat dieses Handle im MiniportDeviceContext Parameter von einem Aufruf an die DxgkDdiAddDevice--Funktion zurückgegeben.

[in] InterruptControl

Eine DXGKARG_CONTROLINTERRUPT3 Struktur, die den Interrupttyp, den VSYNC-Zustand und die VidPnSourceId bereitstellt.

Rückgabewert

DxgkDdi_ControlInterrupt3 gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Interrupttyp wurde auf der Grafikhardware erfolgreich aktiviert oder deaktiviert.
STATUS_NOT_IMPLEMENTED	DxgkDdi_ControlInterrupt3 unterstützt das Aktivieren oder Deaktivieren des angegebenen Interrupttyps nicht.

Bemerkungen

Das VSync-Steuerelement wird in WDDM zum Umschalten von VSync EIN und AUS verwendet, um zwischen der aktiven Nutzung einer VidPn-Quelle durch ein Szenario und leistungseinsparungen durch Deaktivieren von VSync zu ausgleichen. Im Allgemeinen steuert das Betriebssystem die Logik, wann VSync ein- und AUSGESCHALTET bleiben soll, und benachrichtigt den IHV Kernel Mode Driver (KMD) über einen DDI-Aufruf. Die KMD führt die Anforderung aus. Vor Windows 10, Version 2004 (WDDM 2.7), ist die Granularität des VSync-Steuerelements pro Adapter; d. h. für einen bestimmten Adapter gilt das VSync-Steuerelement für jede VidPn-Quelle des Adapters. Ziehen Sie beispielsweise einen Adapter mit zwei VidPn-Quellen in Betracht, die mit zwei verschiedenen Ausgaben verbunden sind. Wenn eine Ausgabe keine Aktivität und keine Consumer für VSync/VBlank enthält, gibt es nur eine Option: Das Betriebssystem muss VSync für die inaktive Ausgabe beibehalten.

Bei tragbaren Dual-Bildschirmgeräten bleibt VSync für einen Bildschirm eingeschaltet, wenn es nicht benötigt wird, erhebliche Stromkosten. Es erfordert, dass der Anzeigecontroller/die Anzeigeverbindung aktiv bleibt und verhindert, dass Panels, die die Self-Refresh-Funktion unterstützen, in einen Low-Frequency-, Low-Power-Self-Refresh-Modus wechseln. In Windows 10, Version 2004 und höher, ermöglicht DxgkDdiControlInterrupt3- eine genauere VSync-Steuerung pro VidPn-Quelle eines Adapters.

Nur ein DxgkDdiControlInterrupt3 oder DxgkDdi_ControlInterrupt2 wird während der Lebensdauer eines Adapters vom Betriebssystem verwendet.

WDDM 2.7-Treiber, die keine DxgkDdi_ControlInterrupt3 implementieren, deaktivieren das unabhängige VidPn VSync-Steuerelement, und das Betriebssystem ruft nur DxgkDdi_ControlInterrupt2auf. Die DXGK_DRIVERCAPS->IndependentVidPnVSync--Funktion muss 0 in Treibern sein, die DxgkDdi_ControlInterrupt3nicht unterstützen; andernfalls schlägt das Betriebssystem die Adapterinitialisierung fehl. Wenn ein Treiber DxgkDdi_ControlInterrupt3implementiert, kann die Funktion auf 0 oder 1 festgelegt werden, um Per-VidPn Unterstützung anzugeben.