DXGKDDI_RECOMMENDFUNCTIONALVIDPN fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction DxgkDdiRecommendFunctionalVidPn crée un VidPN fonctionnel qui peut être implémenté sur un adaptateur d’affichage spécifié.

Syntaxe

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

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

Paramètres

[in] hAdapter

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique DirectX dans le MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

[in] pRecommendFunctionalVidPn

Pointeur vers une structure DXGKARG_RECOMMENDFUNCTIONALVIDPN qui contient des arguments de fonction. L’appelant fournit le membre hRecommendedFunctionalVidPn, qui est un handle vers un objet VidPN vide. DxgkDdiRecommendFunctionalVidPn remplit l’objet VidPN avec les éléments d’un VidPN fonctionnel : topologie, ensembles de modes, modes épinglés.

Valeur de retour

DxgkDdiRecommendFunctionalVidPn retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi à créer un VidPN fonctionnel.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN	La fonction n’a pas pu créer un VidPN fonctionnel.
STATUS_NO_MEMORY	La fonction a échoué, car elle n’a pas pu allouer de mémoire.

Remarques

Un VidPN est fonctionnel s’il répond aux conditions suivantes :

Il a une topologie qui a au moins un chemin d’accès. (Un chemin est une association entre une source et une cible.)
Chaque source et cible de la topologie a un mode épinglé.

Le travail de DxgkDdiRecommendFunctionalVidPn consiste à créer un VidPN fonctionnel qui peut être implémenté sur l’adaptateur d’affichage. La liste suivante fournit les étapes utilisées pour créer un VidPN fonctionnel.

Commencez par un handle vers un objet VidPN vide. Ce handle a été fourni dans le membre hDesiredVidPn de pRecommendFunctionalVidPnArg.
Ajoutez un chemin d’accès (paire source-cible) à la topologie de VidPN.
Créez un jeu de modes source et ajoutez un mode source à l’ensemble. Affectez le mode source défini à la source dans votre chemin d’accès. Épinglez le mode source.
Créez un jeu de mode cible et ajoutez un mode cible à l’ensemble. Affectez le mode cible défini à la cible dans votre chemin d’accès. Épinglez le mode cible.

Pour plus d’informations sur l’ajout de chemins, d’ajout de jeux de modes, d’affectation de modes et de modes de broche, consultez objets et interfaces VidPN.

DxgkDdiRecommendFunctionalVidPn doit être rendu paginable.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Bureau
d’en-tête	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Partager via