DXGKDDI_RECOMMENDVIDPNTOPOLOGY Rückruffunktion (d3dkmddi.h)

Die DxgkDdiRecommendVidPnTopology-Funktion erstellt die Topologie eines angegebenen VidPN oder erweitert die Topologie um einen neuen Pfad zu video vorhandenen Zielen.

Syntax

DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;

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

Parameter

hAdapter

Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.

[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 enthält 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 für die angegebene Quelle abzubrechen. Dieser Rückgabecode ist nur bei der VidPN-Topologieerweiterung zulässig.
STATUS_NO_MEMORY Die Funktion ist fehlgeschlagen, weil sie nicht genügend Arbeitsspeicher zuweisen konnte.

Der Miniporttreiber sollte jeden Fehlercode übergeben, den er vom Betriebssystem erhält, für das er keinen Fallbackcodepfad aufweist.

Hinweise

DxgkDdiRecommendVidPnTopology sollte ausgelagert werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Desktop
Kopfzeile d3dkmddi.h
IRQL PASSIVE_LEVEL

Weitere Informationen

VidPn-Topologieschnittstelle