DXGKDDI_VIDPNTOPOLOGY_REMOVEPATH Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnRemovePath--Funktion entfernt einen Videodatenpfad zu einem angegebenen VidPN-Topologieobjekt.

Syntax

DXGKDDI_VIDPNTOPOLOGY_REMOVEPATH DxgkddiVidpntopologyRemovepath;

NTSTATUS DxgkddiVidpntopologyRemovepath(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId
)
{...}

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 einen VidPN-Quellpfad identifiziert.

[in] VidPnTargetId

Eine ganze Zahl, die einen VidPN-Zielpfad identifiziert.

Rückgabewert

Die pfnRemovePath--Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der angegebene Video present-Pfad wurde erfolgreich aus diesem VidPN-Topologieobjekt entfernt.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE	Der in VidPnSourceId angegebene VidPN-Quellbezeichner ist ungültig.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	Der in VidPnTargetId angegebene VidPN-Zielbezeichner ist ungültig.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	Das in hVidPnTopology bereitgestellte Handle ist ungültig.
STATUS_ACCESS_DENIED	Der Pfad kann nicht im Kontext des aktuellen DDI-Aufrufs entfernt werden.

Bemerkungen

Der D3DKMDT_HVIDPNTOPOLOGY Datentyp wird in D3dkmdt.hdefiniert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL-	PASSIVE_LEVEL

Freigeben über