DXGKDDI_CONTROLINTERRUPT3 Rückruffunktion (d3dkmddi.h)

Artikel
02/26/2024

Die funktion DxgkDdi_ControlInterrupt3 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 (GRAPHICS Processing Unit, GPU). Der Treiber hat dieses Handle im MiniportDeviceContext-Parameter von einem Aufruf seiner 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.

Hinweise

Das VSync-Steuerelement wird in WDDM verwendet, um VSync ein- und auszuschalten, um zwischen der aktiven Nutzung einer VidPn-Quelle durch ein Szenario und energiesparenden Einsparungen durch deaktivieren von VSync zu wechseln. Im Allgemeinen steuert das Betriebssystem die Logik, wann VSync ein- und ausgeschaltet bleiben soll, und benachrichtigt den IHV-Kernelmodustreiber (KMD) über einen DDI-Aufruf. Die KMD führt die Anforderung aus. Vor Windows 10 Version 2004 (WDDM 2.7) gilt die Granularität des VSync-Steuerelements pro Adapter. Für einen bestimmten Adapter gilt das VSync-Steuerelement für jede VidPn-Quelle des Adapters. Betrachten Sie beispielsweise einen Adapter, der über zwei VidPn-Quellen verfügt, die mit zwei verschiedenen Ausgaben verbunden sind. Wenn eine Ausgabe über keine Aktivität und keine Consumer für VSync/VBlank verfügt, gibt es nur eine Option: Das Betriebssystem muss VSync on für die inaktive Ausgabe beibehalten.

Bei tragbaren Dual-Bildschirm-Geräten hat das Beibehalten von VSync für einen Bildschirm, wenn es nicht benötigt wird, erhebliche Stromkosten. Es erfordert, dass der Anzeigecontroller/Display-Link aktiv bleibt, und verhindert, dass Panels, die die Selbstaktualisierung unterstützen, in einen Selbstaktualisierungsmodus mit niedriger Frequenz und geringem Stromverbrauch wechseln. In Windows 10 Version 2004 und höher ermöglicht DxgkDdiControlInterrupt3 eine präzisere VSync-Steuerung pro VidPn-Quelle eines Adapters.

Während der Lebensdauer eines Adapters wird vom Betriebssystem nur einer von DxgkDdiControlInterrupt3 oder DxgkDdi_ControlInterrupt2 verwendet.

WDDM 2.7-Treiber, die keine DxgkDdi_ControlInterrupt3 implementieren, deaktivieren die unabhängige VidPn VSync-Steuerung, und das Betriebssystem ruft nur DxgkDdi_ControlInterrupt2 auf. Die FunktionDXGK_DRIVERCAPS-IndependentVidPnVSync> muss in Treibern, die DxgkDdi_ControlInterrupt3 nicht unterstützen, 0 sein. Andernfalls schlägt die Adapterinitialisierung des Betriebssystems fehl. Wenn ein Treiber DxgkDdi_ControlInterrupt3 implementiert, kann die Funktion auf 0 oder 1 festgelegt werden, um Per-VidPn Unterstützung anzugeben.