DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnReleasePathInfo-Funktion gibt eine D3DKMDT_VIDPN_PRESENT_PATH-Struktur frei, die der VidPN-Manager zuvor für den Anzeigeminiporttreiber 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 für ein VidPN-Topologieobjekt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetTopology-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[in] pVidPnPresentPathInfo

Ein Zeiger auf die D3DKMDT_VIDPN_PRESENT_PATH-Struktur, die freigegeben werden soll.

Rückgabewert

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

Hinweise

Wenn Sie die Verwendung einer D3DKMDT_VIDPN_PRESENT_PATH-Struktur abgeschlossen haben, die Sie durch Aufrufen einer der folgenden Funktionen abgerufen haben, müssen Sie die -Struktur freigeben, indem Sie pfnReleasePathInfo aufrufen.

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 dann entscheiden, den neuen Pfad nicht zu einer Topologie hinzuzufügen, müssen Sie die neu erstellte Struktur 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

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo