DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnReleasePathInfo-Funktion gibt eine D3DKMDT_VIDPN_PRESENT_PATH Struktur frei, die der VidPN-Manager zuvor für den Miniporttreiber bereitgestellt hat.

Syntax

DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;

NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}

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] pVidPnPresentPathInfo

Ein Zeiger auf die D3DKMDT_VIDPN_PRESENT_PATH Struktur, die losgelassen werden soll.

Rückgabewert

Die pfnReleasePathInfo 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_GRAPHICS_INVALID_VIDPN_PRESENT_PATH	Der in pVidPnPresentPathInfo bereitgestellte Zeiger war ungültig.

Bemerkungen

Wenn Sie mit der Verwendung einer D3DKMDT_VIDPN_PRESENT_PATH Struktur fertig sind, die Sie durch Aufrufen einer der folgenden Funktionen erhalten haben, müssen Sie die Struktur freigeben, indem Sie pfnReleasePathInfoaufrufen.

Wenn Sie eine D3DKMDT_VIDPN_PRESENT_PATH Struktur abrufen, indem Sie pfnCreateNewPathInfo aufrufen und diese Struktur dann an pfnAddPathübergeben, müssen Sie die Struktur nicht freigeben.

Wenn Sie ein Handle abrufen, indem Sie pfnCreateNewPathInfo aufrufen und sich dann entscheiden, den neuen Pfad nicht zu einer Topologie hinzuzufügen, müssen Sie die neu erstellte Struktur freigeben, indem Sie pfnReleasePathInfoaufrufen.

Der D3DKMDT_HVIDPNTOPOLOGY Datentyp wird in D3dkmdt.hdefiniert.