DXGKDDI_RECOMMENDFUNCTIONALVIDPN Rückruffunktion (d3dkmddi.h)

Die DxgkDdiRecommendFunctionalVidPn--Funktion erstellt eine funktionale VidPN, die auf einem angegebenen Anzeigeadapter 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 zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber hat dieses Handle zuvor dem DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des 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 einer funktionalen VidPN: Topologie, Modussätze, angeheftete Modi.

Rückgabewert

DxgkDdiRecommendFunctionalVidPn gibt einen der folgenden Werte zurück:

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

Bemerkungen

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

• Sie 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.

Der Auftrag von DxgkDdiRecommendFunctionalVidPn besteht darin, eine funktionale VidPN zu erstellen, die auf dem Displayadapter 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. Dieser Handle wurde im hDesiredVidPn Mitglied von pRecommendFunctionalVidPnArg bereitgestellt.
2. Fügen Sie der Topologie des VidPN einen Pfad (Quellzielpaar) hinzu.
3. Erstellen Sie einen neuen Quellmodussatz, und fügen Sie dem Satz einen Quellmodus hinzu. Weisen Sie dem Quellmodus, der auf die Quelle in Ihrem Pfad festgelegt ist, zu. Heften Sie den Quellmodus an.
4. Erstellen Sie einen neuen Zielmodussatz, und fügen Sie dem Satz einen Zielmodus hinzu. Weisen Sie dem Zielmodus in Ihrem Pfad den festgelegten Zielmodus zu. Heften Sie den Zielmodus an.

Informationen zum Hinzufügen von Pfaden, Hinzufügen von Modussätzen, Zuweisen von Modi und Pinmodi finden Sie unter VidPN-Objekte und -Schnittstellen.

DxgkDdiRecommendFunctionalVidPn sollte seitenfähig gemacht werden.

Anforderungen

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