DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAcquireNextPathInfo-Funktion gibt einen Deskriptor des nächsten Videodatenpfads in einer angegebenen VidPN-Topologie zurück, je nach dem aktuellen Pfad.

Syntax

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}

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 eine D3DKMDT_VIDPN_PRESENT_PATH Struktur, die den aktuellen Pfad beschreibt. Der Display-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen pfnAcquireFirstPathInfo oder pfnAcquireNextPathInfoabgerufen.

[out] ppNextVidPnPresentPathInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_PRESENT_PATH Struktur empfängt, die den nächsten Pfad beschreibt.

Rückgabewert

Die pfnAcquireNextPathInfo 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.

Bemerkungen

Wenn Sie die D3DKMDT_VIDPN_PRESENT_PATH-Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleasePathInfoaufrufen.

Sie können alle Pfade, die zu einem VidPN-Topologieobjekt gehören, aufzählen, indem Sie pfnAcquireFirstPathInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextPathInfo.

Der D3DKMDT_HVIDPNTOPOLOGY Datentyp wird in D3dkmdt.hdefiniert.