DXGKDDI_RECOMMENDFUNCTIONALVIDPN fonction de rappel (d3dkmddi.h)

Article
05/26/2023

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

Syntaxe

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

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

Paramètres

[in] hAdapter

Handle d’un bloc de contexte associé à une carte d’affichage. Le pilote miniport d’affichage a précédemment fourni cette poignée au sous-système du noyau graphique DirectX dans le paramètre de sortie MiniportDeviceContext 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 pour un objet VidPN vide. DxgkDdiRecommendFunctionalVidPn remplit l’objet VidPN avec les éléments d’un VidPN fonctionnel : topologie, jeux de modes, modes épinglés.

Valeur retournée

DxgkDdiRecommendFunctionalVidPn retourne l’une des valeurs suivantes :

Code de retour	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 remplit les conditions suivantes :

Il a une topologie qui a au moins un chemin. (Un chemin d’accès 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 la carte d’affichage. La liste suivante répertorie les étapes utilisées pour créer un VidPN fonctionnel.

Commencez par un handle pour 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 du VidPN.
Créez un nouveau 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. Épingler le mode source.
Créez un nouvel ensemble de modes cibles et ajoutez un mode cible à l’ensemble. Affectez le mode cible défini à la cible dans votre chemin d’accès. Épingler le mode cible.

Pour plus d’informations sur l’ajout de chemins, l’ajout de jeux de modes, l’attribution de modes et les modes d’épingle, consultez Objets et interfaces VidPN.

DxgkDdiRecommendFunctionalVidPn doit être rendu paginable.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Partager via