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