DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO Rückruffunktion (d3dkmddi.h)
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 |