DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE Rückruffunktion (d3dkmddi.h)
Die pfnEnumPathTargetsFromSource-Funktion gibt den Bezeichner eines der vorhandenen Videoziele zurück, die einer angegebenen Videoquelle 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 für ein VidPN-Topologieobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnGetTopology-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.
[in] VidPnSourceId
Eine ganze Zahl, die eine bestimmte Videoquelle identifiziert.
[in] VidPnPresentPathIndex
Ein nullbasierter Index in den Satz von Pfaden, die die von VidPnSourceId identifizierte Quelle enthalten.
[out] pVidPnTargetId
Ein Zeiger auf eine Variable, die den Zielbezeichner empfängt.
Rückgabewert
Die pfnEnumPathTargetsFromSource-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. |
| STATUS_INVALID_PARAMETER | Der in pVidPnTargetId angegebene Zeiger war gültig. |
Hinweise
VidPnPresentPathIndex ist kein Index für die Gruppe aller Pfade in der Topologie, die durch hVidPnTopology identifiziert wird. Es ist ein Index in eine Teilmenge aller Pfade in der Topologie: insbesondere die Teilmenge aller Pfade, die die von VidPnSourceId identifizierte Quelle enthalten.
Führen Sie die folgenden Schritte aus, um (in einer bestimmten Topologie) alle Ziele aufzulisten, die einer bestimmten Quelle zugeordnet sind.
Rufen Sie pfnGetNumPathsFromSource auf, um die Anzahl N der Pfade zu ermitteln, die die Quelle von Interesse enthalten. Stellen Sie sich diese Pfade als indizierte Menge mit Indizes 0, 1, ... N - 1.
Übergeben Sie für jeden Index 0 bis N bis 1 den Quellbezeichner und den Index an pfnEnumPathTargetsFromSource.
Eine Topologie ist eine Auflistungspfade, die jeweils ein Paar (Quelle, Ziel) enthält. Es ist möglich, dass eine bestimmte Quelle in mehr als einem Pfad angezeigt wird. Im Fall einer Klonansicht kann beispielsweise eine Quelle mit zwei unterschiedlichen Zielen gekoppelt werden.
VidPN-Quellbezeichner werden vom Betriebssystem zugewiesen. DxgkDdiStartDevice, das vom Anzeigeminiporttreiber implementiert wurde, gibt die Anzahl N der vom Grafikkarte unterstützten Videoquellen zurück. Dann weist das Betriebssystem die Bezeichner 0, 1, 2, ... N - 1.
VidPN-Zielbezeichner werden vom Anzeigeminiporttreiber zugewiesen. DxgkDdiQueryChildRelations, das vom Anzeigeminiporttreiber implementiert wird, 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.h definiert.
Die Datentypen D3DDDI_VIDEO_PRESENT_SOURCE_ID und D3DDDI_VIDEO_PRESENT_TARGET_ID werden in D3dukmdt.h definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |