DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE Rückruffunktion (d3dkmddi.h)
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 |