DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE Rückruffunktion (d3dkmddi.h)

  • Artikel

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

Weitere Informationen

pfnGetNumPathsFromSource

pfnGetPathSourceFromTarget