DXGKDDI_RECOMMENDVIDPNTOPOLOGY Rückruffunktion (d3dkmddi.h)

Die DxgkDdiRecommendVidPnTopology--Funktion erstellt die Topologie einer angegebenen VidPN oder erweitert die Topologie mit einem neuen Pfad zu Videoobjekten.

Syntax

DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;

NTSTATUS DxgkddiRecommendvidpntopology(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}

Parameter

hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber, der zuvor dieses Handle für das Microsoft DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt hat.

[in] pRecommendVidPnTopology

Ein Zeiger auf eine DXGKARG_RECOMMENDVIDPNTOPOLOGY Struktur, die Funktionsargumente enthält.

Rückgabewert

DxgkDdiRecommendVidPnTopology gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat die Topologie erfolgreich erstellt oder erweitert.
STATUS_GRAPHICS_NO_RECOMMENDED_VIDPN_TOPOLOGY	Die Funktion hat keine Empfehlung für die Erweiterung der angegebenen VidPN-Topologie.
STATUS_GRAPHICS_CANCEL_VIDPN_TOPOLOGY_AUGMENTATION	Die Funktion empfiehlt, die Erweiterung der angegebenen VidPN-Topologie in der angegebenen Quelle abzubrechen. Dieser Rückgabecode ist nur im Fall der VidPN-Topologieerweiterung zulässig.
STATUS_NO_MEMORY	Fehler bei der Funktion, da sie nicht genügend Arbeitsspeicher zuordnen konnte.

Der Miniporttreiber sollte einen Fehlercode durchlaufen, der vom Betriebssystem abgerufen wird, für das er keinen Fallbackcodepfad aufweist.

Bemerkungen

DxgkDdiRecommendVidPnTopology- sollte seitenfähig gemacht werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	d3dkmddi.h
IRQL-	PASSIVE_LEVEL

Siehe auch

VidPn-Topologieschnittstelle