DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnGetPathSourceFromTarget-Funktion gibt den Bezeichner der Videoquelle zurück, die einem angegebenen Video präsenten Ziel zugeordnet ist.

Syntax

DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;

NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}

Parameter

[in] hVidTopology

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] VidPnTargetId

Eine ganze Zahl, die eine bestimmte Videoquelle identifiziert.

[out] pVidPnSourceId

Ein Zeiger auf eine Variable, die den Bezeichner der vorliegenden Videoquelle empfängt.

Rückgabewert

Die pfnGetPathSourceFromTarget-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 pVidPnSourceId angegebene Zeiger war gültig.

Hinweise

Eine Topologie ist eine Auflistungspfade, die jeweils ein Paar (Quelle, Ziel) enthält. Ein bestimmtes Ziel gehört höchstens zu einem Pfad, sodass bei einer Ziel-ID höchstens eine Quelle diesem Ziel zugeordnet ist.

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 D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID Datentypen 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

pfnEnumPathTargetsFromSource