DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH Rückruffunktion (d3dkmddi.h)

Artikel
05/26/2023

Die DxgkDdiUpdateActiveVidPnPresentPath-Funktion aktualisiert einen der Videodatenpfade, der derzeit auf der Grafikkarte aktiv ist.

Syntax

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

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

Parameter

hAdapter

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

[in] pUpdateActiveVidPnPresentPath

Ein Zeiger auf eine DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH-Struktur , die ein Element enthält: eine D3DKMDT_VIDPN_PRESENT_PATH-Struktur . Die Member 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

DxgkDdiUpdateActiveVidPnPresentPathgibt einen der folgenden Werte zurück:

Wert	BESCHREIBUNG
STATUS_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Der von pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo> angegebene Pfad 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.ContentTransformation> angegebene Inhaltstransformation nicht. Der Pfad unterstützt die von pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.GammaRamp> angegebene Gammarampe nicht.

Hinweise

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

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

Wenn der Display-Miniporttreiber ab Windows 8 den SupportSmoothRotation-Member der DXGK_DRIVERCAPS-Struktur festlegt, muss er das Aktualisieren der Pfadrotation auf dem Adapter mithilfe der DxgkDdiUpdateActiveVidPnPresentPath-Funktion unterstützen. Der Treiber muss immer in der Lage sein, die Pfadrotation während eines Aufrufs der DxgkDdiCommitVidPn-Funktion festzulegen.

Die DxgkDdiUpdateActiveVidPnPresentPath-Funktion sollte ausgelagert werden.