DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE Rückruffunktion (d3dkmddi.h)
Die pfnEnumPathTargetsFromSource--Funktion gibt den Bezeichner eines der Videoobjekte zurück, die einer angegebenen Videoreferentquelle zugeordnet sind.
Syntax
DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE DxgkddiVidpntopologyEnumpathtargetsfromsource;
NTSTATUS DxgkddiVidpntopologyEnumpathtargetsfromsource(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DKMDT_VIDPN_PRESENT_PATH_INDEX VidPnPresentPathIndex,
[out] OUT_PD3DDDI_VIDEO_PRESENT_TARGET_ID pVidPnTargetId
)
{...}
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 bestimmte Videoquelle identifiziert.
[in] VidPnPresentPathIndex
Ein nullbasierter Index in der Gruppe von Pfaden, die die durch VidPnSourceIdidentifizierte Quelle enthalten.
[out] pVidPnTargetId
Ein Zeiger auf eine Variable, die den Zielbezeichner empfängt.
Rückgabewert
Die funktion pfnEnumPathTargetsFromSource 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. |
| STATUS_INVALID_PARAMETER | Der in pVidPnTargetId angegebene Zeiger war gültig. |
Bemerkungen
VidPnPresentPathIndex- ist kein Index in der Gruppe aller Pfade in der Topologie, die durch hVidPnTopologyidentifiziert wird. Es ist ein Index in einer Teilmenge aller Pfade in der Topologie: insbesondere die Teilmenge aller Pfade, die die durch VidPnSourceIdidentifizierte Quelle enthalten.
Führen Sie die folgenden Schritte aus, um alle mit einer bestimmten Quelle verbundenen Ziele (in einer bestimmten Topologie) auflisten zu können.
Rufen Sie pfnGetNumPathsFromSource- auf, um die Anzahl der Pfade zu bestimmen, die die Quelle von Interesse enthalten. Stellen Sie sich diese Pfade als indizierten Satz mit Indizes 0, 1, ... N - 1.
Übergeben Sie für jeden Index 0, obwohl N - 1, den Quellbezeichner und den Index an pfnEnumPathTargetsFromSource.
Eine Topologie ist ein Sammlungspfad, von dem jedes ein (Quell-, Ziel-)Paar enthält. Es ist möglich, dass eine bestimmte Quelle in mehr als einem Pfad angezeigt wird. Beispielsweise kann eine Quelle mit zwei unterschiedlichen Zielen im Fall einer Klonansicht gekoppelt werden.
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.
Die Datentypen D3DKMDT_HVIDPNTOPOLOGY und D3DKMDT_VIDPN_PRESENT_PATH_INDEX werden 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 |