DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE Rückruffunktion (d3dkmddi.h)
Die pfnGetNumPathsFromSource--Funktion gibt die Anzahl der Videodatenpfade zurück, die eine angegebene Videoreferentquelle 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 zu einem VidPN-Topologieobjekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetTopology- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle erhalten.
[in] VidPnSourceId
Eine ganze Zahl, die eine bestimmte Videoquelle identifiziert.
[out] pNumPathsFromSource
Ein Zeiger auf eine variable SIZE_T typisiert, die die Anzahl der Pfade empfängt, die die angegebene Quelle enthalten.
Rückgabewert
Die funktion pfnGetNumPathsFromSource gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | Das in hVidPnTopology bereitgestellte Handle war ungültig. |
| STATUS_INVALID_PARAMETER | Der in pNumPathsFromSource bereitgestellte Zeiger war gültig. |
Bemerkungen
Eine Topologie ist ein Sammlungspfad, von dem jedes ein (Quell-, Ziel-)Paar enthält. Es ist möglich, dass eine bestimmte Quelle in mehr als einem Pfad angezeigt wird. Beispielsweise kann eine Quelle mit zwei unterschiedlichen Zielen im Fall einer Klonansicht gekoppelt werden.
VidPN-Quellbezeichner werden vom Betriebssystem zugewiesen. DxgkDdiStartDevice, implementiert vom Display Miniport-Treiber, gibt die Anzahl N der vom Displayadapter unterstützten Videoquellen zurück. Anschließend weist das Betriebssystem Bezeichner 0, 1, 2, ... N - 1.
Der D3DKMDT_HVIDPNTOPOLOGY Datentyp wird in D3dkmdt.hdefiniert.
Der D3DDDI_VIDEO_PRESENT_SOURCE_ID Datentyp wird in D3dukmdt.hdefiniert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |