DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdiUpdateActiveVidPnPresentPath-Funktion aktualisiert einen der Videodatenpfade, die derzeit auf dem Anzeigeadapter aktiv sind.

Syntax

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

NTSTATUS DxgkddiUpdateactivevidpnpresentpath(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_UPDATEACTIVEVIDPNPRESENTPATH_CONST pUpdateActiveVidPnPresentPath
)
{...}

Parameter

hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber, der zuvor dieses Handle für das Microsoft DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt hat.

[in] pUpdateActiveVidPnPresentPath

Ein Zeiger auf eine DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH Struktur, die ein Element enthält: eine D3DKMDT_VIDPN_PRESENT_PATH Struktur. Die Elemente der D3DKMDT_VIDPN_PRESENT_PATH Struktur identifizieren den Pfad und geben neue Einstellungen für den Pfad an. Die DxgkDdiUpdateActiveVidPnPresentPath- Funktion muss den Pfad auf dem Anzeigeadapter entsprechend den neuen Einstellungen programmieren.

Rückgabewert

DxgkDdiUpdateActiveVidPnPresentPatheinen der folgenden Werte zurück:

Wert	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Der durch pUpdateActiveVidPnPresentPathArgangegebene Pfad ->VidPnPresentPathInfo- befindet sich nicht in der Topologie des aktiven VidPN.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	Der Pfad unterstützt die von pUpdateActiveVidPnPresentPathArg->VidPnPresentPathInfo.ContentTransformationangegebene Inhaltstransformation nicht. Der Pfad unterstützt nicht die gammahierarchie, die durch pUpdateActiveVidPnPresentPathArg->VidPnPresentPathInfo.GammaRampangegeben wird.

Bemerkungen

Das Betriebssystem ruft die DxgkDdiUpdateActiveVidPnPresentPath--Funktion auf, um die Einstellungen von Videopräsentationspfaden zu steuern, z. B. Pfaddrehung, Geometrietransformationen eines präsentierten Inhalts, Gammahierarchien, die zum Anpassen der Helligkeit des präsentierten Inhalts usw. verwendet werden.

Hinweis Die DxgkDdiUpdateActiveVidPnPresentPath- Funktion des Anzeigeminiporttreibers muss Gammahierarchien unterstützen.

Ab Windows 8 muss das Aktualisieren der Pfaddrehung auf dem Adapter mithilfe der DxgkDdiUpdateActiveVidPnPresent Path Member der DXGK_DRIVERCAPS-Struktur unterstützt werden. Der Treiber muss während eines Aufrufs der DxgkDdiCommitVidPn Funktion immer in der Lage sein, die Pfaddrehung festzulegen.

Die DxgkDdiUpdateActiveVidPnPresentPath--Funktion sollte seitenfähig gemacht werden.