DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnAcquireNextPathInfo-Funktion gibt einen Deskriptor des nächsten Videodatenpfads in einer angegebenen VidPN-Topologie zurück, wenn der aktuelle Pfad angegeben ist.

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

[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 wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY Das in hVidPnTopology angegebene Handle war ungültig.

Hinweise

Wenn Sie die Verwendung der D3DKMDT_VIDPN_PRESENT_PATH-Struktur abgeschlossen haben, müssen Sie die -Struktur freigeben, indem Sie pfnReleasePathInfo aufrufen.

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

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

pfnReleasePathInfo