DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnAcquirePathInfo-Funktion gibt einen Deskriptor des Video präsenten Pfads zurück, der von einer Videovorstellungsquelle und einem video present-Ziel 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 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 vorhandene Videoquelle identifiziert.

[in] VidPnTargetId

Eine ganzzahlige Zahl, die ein vorhandenes Videoziel identifiziert.

[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 wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY Das in hVidPnTopology angegebene Handle war ungültig.

Hinweise

Wenn Sie die verwendung der D3DKMDT_VIDPN_PRESENT_PATH-Struktur abgeschlossen haben, müssen Sie die Struktur freigeben, indem Sie pfnReleasePathInfo aufrufen.

Ein Pfad enthält ein (Quell-, Ziel-)Paar, und eine Topologie ist eine Auflistung von Pfaden. Diese Funktion gibt einen Deskriptor für den Pfad in einer angegebenen Topologie zurück, der ein angegebenes Paar (Quelle, Ziel) enthält.

Sie können alle Pfade auflisten, die zu einem VidPN-Topologieobjekt gehören, indem Sie pfnAcquireFirstPathInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextPathInfo ausführen.

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.

Der D3DKMDT_HVIDPNTOPOLOGY Datentyp ist 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

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo

pfnReleasePathInfo