DXGKDDI_VIDPNTOPOLOGY_ADDPATH Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAddPath--Funktion fügt einem angegebenen VidPN-Topologieobjekt einen Video present-Pfad hinzu.

Syntax

DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;

NTSTATUS DxgkddiVidpntopologyAddpath(
  [in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}

Parameter

[in] hVidPnTopology

Ein Handle zu einem VidPN-Topologieobjekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetTopology- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle erhalten.

[in] pVidPnPresentPath

Ein Zeiger auf eine D3DKMDT_VIDPN_PRESENT_PATH Struktur, die den Pfad beschreibt. Der Display-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen pfnCreateNewPathInfoabgerufen.

Rückgabewert

Die pfnAddPath--Funktion gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	Das in hVidPnTopology bereitgestellte Handle war ungültig.
STATUS_ACCESS_DENIED	Der Pfad kann nicht im Kontext des aktuellen DDI-Aufrufs entfernt werden.

Bemerkungen

Zum Hinzufügen eines Pfads zu einer Topologie führt der Anzeige-Miniporttreiber die folgenden Schritte aus.

Rufen Sie pfnCreateNewPathInfo- auf, um einen Zeiger auf eine vom VidPN-Manager zugewiesene D3DKMDT_VIDPN_PRESENT_PATH Struktur abzurufen.

Füllen Sie die D3DKMDT_VIDPN_PRESENT_PATH Struktur mit Informationen zum Pfad auf, einschließlich Video, die Quell- und Ziel-IDs darstellen.

Rufen Sie pfnAddPath- auf, um den Pfad zu einer Topologie hinzuzufügen.

Der VidPN-Manager weist eine D3DKMDT_VIDPN_PRESENT_PATH Struktur zu, wenn Sie pfnCreateNewPathInfoaufrufen. Wenn Sie den von dieser Struktur beschriebenen Pfad zu einer Topologie hinzufügen, müssen Sie die Struktur nicht explizit freigeben. pfnAddPath veröffentlicht sie.

Wenn Sie eine D3DKMDT_VIDPN_PRESENT_PATH Struktur abrufen, indem Sie pfnCreateNewPathInfo aufrufen und dann beschließen, diesen Pfad nicht zu einer Topologie hinzuzufügen, müssen Sie die Struktur explizit freigeben, indem Sie pfnReleasePathInfoaufrufen.

Der D3DKMDT_HVIDPNTOPOLOGY Datentyp wird in D3dkmdt.hdefiniert.