DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET Rückruffunktion (d3dkmddi.h)
Die pfnGetPathSourceFromTarget--Funktion gibt den Bezeichner der Video present-Quelle zurück, die einem angegebenen Ziel für Videos 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 zu einem VidPN-Topologieobjekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetTopology- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle erhalten.
[in] VidPnTargetId
Eine ganze Zahl, die eine bestimmte Videoquelle identifiziert.
[out] pVidPnSourceId
Ein Zeiger auf eine Variable, die den Bezeichner der Quelle für die Videowiedergabe empfängt.
Rückgabewert
Die pfnGetPathSourceFromTarget Funktion 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 pVidPnSourceId angegebene Zeiger war gültig. |
Bemerkungen
Eine Topologie ist ein Sammlungspfad, von dem jedes ein (Quell-, Ziel-)Paar enthält. Ein bestimmtes Ziel gehört höchstens einem Pfad, sodass aufgrund einer Ziel-ID höchstens eine Quelle diesem Ziel zugeordnet ist.
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.
VidPN-Ziel-IDs werden vom Anzeigeminiporttreiber zugewiesen. DxgkDdiQueryChildRelations, implementiert vom Display Miniport-Treiber, gibt ein Array von DXGK_CHILD_DESCRIPTOR Strukturen zurück, die jeweils einen Bezeichner enthalten.
Der D3DKMDT_HVIDPNTOPOLOGY Datentyp wird in D3dkmdt.hdefiniert.
Die D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID Datentypen werden in D3dukmdt.hdefiniert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |