DXGKDDI_VIDPNSOURCEMODESET_ADDMODE fonction de rappel (d3dkmddi.h)

La fonction pfnAddMode ajoute un mode source VidPN à un objet défini de mode source VidPN spécifié.

Syntaxe

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Paramètres

[in] hVidPnSourceModeSet

Handle vers un objet défini en mode source VidPN. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnAcquireSourceModeSet de l’interface DXGK_VIDPN_INTERFACE .

[in] pVidPnSourceModeInfo

Pointeur vers une structure D3DKMDT_VIDPN_SOURCE_MODE qui décrit le mode source. Le pilote miniport d’affichage a précédemment obtenu cette structure en appelant pfnCreateNewModeInfo.

Valeur retournée

La fonction pfnAddMode retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Le handle fourni dans hVidPnSourceModeSet n’était pas valide.

Remarques

Pour ajouter un mode à un ensemble de modes source, le pilote miniport d’affichage effectue les étapes suivantes.

Appelez pfnCreateNewModeInfo pour obtenir un pointeur vers une structure D3DKMDT_VIDPN_SOURCE_MODE . La fonction pnfCreateNewModeInfo alloue la structure, remplit le membre Id avec un identificateur de mode source nouvellement généré et définit le membre Type sur D3DKMDT_RMT_UNINITIALIZED.

Renseignez la structure D3DKMDT_VIDPN_SOURCE_MODE (à l’exception du membre Id ) avec des informations sur le mode, y compris le type et le format du mode.

Appelez pfnAddMode pour ajouter le mode à un mode source défini.

Le gestionnaire VidPN alloue une structure D3DKMDT_VIDPN_SOURCE_MODE lorsque vous appelez pfnCreateNewModeInfo. Si vous ajoutez le mode décrit par cette structure à un ensemble de modes source, vous n’avez pas besoin de libérer explicitement la structure ; pfnAddMode le libère.

Si vous obtenez une structure D3DKMDT_VIDPN_SOURCE_MODE en appelant pfnCreateNewModeInfo et que vous décidez de ne pas ajouter ce mode à un ensemble de modes source, vous devez libérer explicitement la structure en appelant pfnReleaseModeInfo.

Le type de données D3DKMDT_HVIDPNSOURCEMODESET est défini dans D3dkmdt.h.

Configuration requise

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

Voir aussi

D3DKMDT_VIDPN_SOURCE_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo