DXGKDDI_RECOMMENDFUNCTIONALVIDPN Rückruffunktion (d3dkmddi.h)

  • Artikel

Die DxgkDdiRecommendFunctionalVidPn-Funktion erstellt eine funktionale VidPN, die auf einem angegebenen Grafikkarte implementiert werden kann.

Syntax

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}

Parameter

[in] hAdapter

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

[in] pRecommendFunctionalVidPn

Ein Zeiger auf eine DXGKARG_RECOMMENDFUNCTIONALVIDPN-Struktur , die Funktionsargumente enthält. Der Aufrufer stellt den hRecommendedFunctionalVidPn-Member bereit, der ein Handle für ein leeres VidPN-Objekt ist. DxgkDdiRecommendFunctionalVidPn füllt das VidPN-Objekt mit den Elementen eines funktionalen VidPN auf: Topologie, Modussätze, angeheftete Modi.

Rückgabewert

DxgkDdiRecommendFunctionalVidPn gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion konnte eine funktionale VidPN erstellen.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN Die Funktion konnte keine funktionale VidPN erstellen.
STATUS_NO_MEMORY Bei der Funktion ist ein Fehler aufgetreten, da der Speicher nicht zugeordnet werden konnte.

Hinweise

Ein VidPN ist funktionsfähig, wenn er die folgenden Bedingungen erfüllt:

  • Es verfügt über eine Topologie mit mindestens einem Pfad. (Ein Pfad ist eine Zuordnung zwischen einer Quelle und einem Ziel.)
  • Jede Quelle und jedes Ziel in der Topologie verfügt über einen angehefteten Modus.
Die Aufgabe von DxgkDdiRecommendFunctionalVidPn besteht darin, eine funktionale VidPN zu erstellen, die auf der Grafikkarte implementiert werden kann. Die folgende Liste enthält die Schritte zum Erstellen eines funktionalen VidPN.
  1. Beginnen Sie mit einem Handle für ein leeres VidPN-Objekt. Dieses Handle wurde im hDesiredVidPn-Member von pRecommendFunctionalVidPnArg bereitgestellt.
  2. Fügen Sie der Topologie des VidPN einen Pfad (Quell-Ziel-Paar) hinzu.
  3. Erstellen Sie einen neuen Quellmodussatz, und fügen Sie dem Satz einen Quellmodus hinzu. Weisen Sie den Quellmodus zu, der auf die Quelle in Ihrem Pfad festgelegt ist. Anheften des Quellmodus.
  4. Erstellen Sie einen neuen Zielmodussatz, und fügen Sie der Gruppe einen Zielmodus hinzu. Weisen Sie den Zielmodus dem Ziel in Ihrem Pfad zu. Anheften des Zielmodus.
Informationen zum Hinzufügen von Pfaden, Hinzufügen von Modussätzen, Zuweisen von Modi und Anheftungsmodi finden Sie unter VidPN-Objekte und -Schnittstellen.

DxgkDdiRecommendFunctionalVidPn sollte als seitenfähig gemacht werden.

Anforderungen

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