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 zu einem VidPN-Topologieobjekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetTopology- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle erhalten.
[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 Ziel-IDs des Pfads.
Rückgabewert
Die pfnAcquireFirstPathInfo 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |