DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO Rückruffunktion (d3dkmddi.h)
Die pfnAcquirePathInfo--Funktion gibt einen Deskriptor des video present-Pfads zurück, der durch eine Video present-Quelle und ein video present target innerhalb einer bestimmten VidPN-Topologie angegeben wird.
Syntax
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
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] VidPnSourceId
Eine ganze Zahl, die eine Quelle für die Präsentation eines Videos identifiziert.
[in] VidPnTargetId
Eine ganze Zahl, die ein Video darstellt, das das Ziel darstellt.
[out] ppVidPnPresentPathInfo
Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_PRESENT_PATH Struktur empfängt, die den angeforderten Pfad beschreibt.
Rückgabewert
Die pfnAcquirePathInfo 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.
Ein Pfad enthält ein (Quell-, Ziel-)Paar, und eine Topologie ist eine Sammlung von Pfaden. Diese Funktion gibt einen Deskriptor für den Pfad in einer angegebenen Topologie zurück, die ein angegebenes (Quell-, Ziel)-Paar enthält.
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.
VidPN-Quellbezeichner werden vom Betriebssystem zugewiesen. DxgkDdiStartDevice, implementiert vom Display Miniport-Treiber, gibt die Anzahl N der vom Displayadapter unterstützten Videoquellen zurück. Anschließend weist das Betriebssystem Bezeichner 0, 1, 2, ... N - 1.
VidPN-Ziel-IDs werden vom Anzeigeminiporttreiber zugewiesen. DxgkDdiQueryChildRelations, implementiert vom Display Miniport-Treiber, gibt ein Array von DXGK_CHILD_DESCRIPTOR Strukturen zurück, die jeweils einen Bezeichner enthalten.
Der D3DKMDT_HVIDPNTOPOLOGY Datentyp wird in D3dkmdt.hdefiniert.
Die Datentypen D3DDDI_VIDEO_PRESENT_SOURCE_ID und D3DDDI_VIDEO_PRESENT_TARGET_ID werden in D3dukmdt.hdefiniert.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows Vista |
Zielplattform- | Desktop |
Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
IRQL- | PASSIVE_LEVEL |