DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO Rückruffunktion (d3dkmddi.h)

Die pfnAcquireFirstPathInfo-Struktur gibt einen Deskriptor des ersten Pfads in einem angegebenen VidPN-Topologieobjekt zurück.

Syntax

DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}

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.

[out] ppFirstVidPnPresentPathInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_PRESENT_PATH-Struktur empfängt. Die Struktur enthält eine Vielzahl von Informationen zum Pfad, einschließlich der Quell- und Zielbezeichner des Pfads.

Rückgabewert

Die PfnAcquireFirstPathInfo-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 auflisten, 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

pfnAcquireNextPathInfo

pfnReleasePathInfo