DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnGetNumPathsFromSource-Funktion gibt die Anzahl der vorhandenen Videopfade zurück, die eine angegebene Videoquelle enthalten.

Syntax

DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE DxgkddiVidpntopologyGetnumpathsfromsource;

NTSTATUS DxgkddiVidpntopologyGetnumpathsfromsource(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PSIZE_T pNumPathsFromSource
)
{...}

Parameter

[in] hVidPnTopology

Ein Handle für ein VidPN-Topologieobjekt. Der Anzeige-Miniporttreiber 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.

[out] pNumPathsFromSource

Ein Zeiger auf eine SIZE_T typisierte Variable, die die Anzahl der Pfade empfängt, die die angegebene Quelle enthalten.

Rückgabewert

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

Hinweise

Eine Topologie ist ein Sammlungspfad, der jeweils ein Paar (Quelle, Ziel) enthält. Es ist möglich, dass eine bestimmte Quelle in mehr als einem Pfad angezeigt wird. Beispielsweise kann eine Quelle im Fall einer Klonansicht mit zwei unterschiedlichen Zielen gekoppelt werden.

VidPN-Quellbezeichner werden vom Betriebssystem zugewiesen. DxgkDdiStartDevice, das vom Anzeigeminiporttreiber implementiert wurde, gibt die Anzahl N der von der Grafikkarte unterstützten Videoquellen zurück. Dann weist das Betriebssystem die Bezeichner 0, 1, 2, ... N - 1.

Der D3DKMDT_HVIDPNTOPOLOGY Datentyp ist in D3dkmdt.h definiert.

Der datentyp D3DDDI_VIDEO_PRESENT_SOURCE_ID wird 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

pfnGetNumPaths