DXGKDDI_VIDPNTOPOLOGY_ADDPATH Rückruffunktion (d3dkmddi.h)

Die pfnAddPath-Funktion fügt einem angegebenen VidPN-Topologieobjekt einen Videodatenpfad 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 für ein VidPN-Topologieobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnGetTopology-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[in] pVidPnPresentPath

Ein Zeiger auf eine D3DKMDT_VIDPN_PRESENT_PATH Struktur, die den Pfad beschreibt. Der Anzeigeminiporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnCreateNewPathInfo abgerufen.

Rückgabewert

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

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

Hinweise

Um einer Topologie einen Pfad hinzuzufügen, führt der Anzeigeminiporttreiber 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, einschließlich Videobezeichnern und Zielbezeichnern.

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 pfnCreateNewPathInfo aufrufen. Wenn Sie den von dieser Struktur beschriebenen Pfad zu einer Topologie hinzufügen, müssen Sie die Struktur nicht explizit freigeben. pfnAddPath gibt es frei.

Wenn Sie eine D3DKMDT_VIDPN_PRESENT_PATH-Struktur erhalten, indem Sie pfnCreateNewPathInfo aufrufen und dann entscheiden, diesen Pfad nicht zu einer Topologie hinzuzufügen, müssen Sie die Struktur explizit freigeben, indem Sie pfnReleasePathInfo aufrufen.

Der D3DKMDT_HVIDPNTOPOLOGY Datentyp ist in D3dkmdt.h definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo

pfnReleasePathInfo