DXGKDDI_VIDPNTOPOLOGY_ADDPATH Rückruffunktion (d3dkmddi.h)
Die pfnAddPath-Funktion fügt einem angegebenen VidPN-Topologieobjekt einen Videodatenpfad hinzu.
Syntax
DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;
NTSTATUS DxgkddiVidpntopologyAddpath(
[in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}
Parameter
[in] hVidPnTopology
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] pVidPnPresentPath
Ein Zeiger auf eine D3DKMDT_VIDPN_PRESENT_PATH Struktur, die den Pfad beschreibt. Der Anzeigeminiporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnCreateNewPathInfo abgerufen.
Rückgabewert
Die pfnAddPath-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_ACCESS_DENIED | Der Pfad kann nicht im Kontext des aktuellen DDI-Aufrufs entfernt werden. |
Hinweise
Um einer Topologie einen Pfad hinzuzufügen, führt der Anzeigeminiporttreiber die folgenden Schritte aus.
Rufen Sie pfnCreateNewPathInfo auf, um einen Zeiger auf eine vom VidPN-Manager zugewiesene D3DKMDT_VIDPN_PRESENT_PATH Struktur abzurufen.
Füllen Sie die D3DKMDT_VIDPN_PRESENT_PATH-Struktur mit Informationen zum Pfad, einschließlich Videobezeichnern und Zielbezeichnern.
Rufen Sie pfnAddPath auf, um den Pfad zu einer Topologie hinzuzufügen.
Der VidPN-Manager weist eine D3DKMDT_VIDPN_PRESENT_PATH-Struktur zu, wenn Sie pfnCreateNewPathInfo aufrufen. Wenn Sie den von dieser Struktur beschriebenen Pfad zu einer Topologie hinzufügen, müssen Sie die Struktur nicht explizit freigeben. pfnAddPath gibt es frei.
Wenn Sie eine D3DKMDT_VIDPN_PRESENT_PATH-Struktur erhalten, indem Sie pfnCreateNewPathInfo aufrufen und dann entscheiden, diesen Pfad nicht zu einer Topologie hinzuzufügen, müssen Sie die Struktur explizit freigeben, indem Sie pfnReleasePathInfo aufrufen.
Der D3DKMDT_HVIDPNTOPOLOGY Datentyp ist in D3dkmdt.h definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |