Partager via


DXGKDDI_VIDPNTARGETMODESET_ADDMODE fonction de rappel (d3dkmddi.h)

La fonction pfnAddMode ajoute un mode cible VidPN à un objet défini en mode cible VidPN spécifié.

Syntaxe

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Paramètres

[in] hVidPnTargetModeSet

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

[in] pVidPnTargetModeInfo

Pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE qui décrit le mode cible. 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_TARGETMODESET Le handle fourni dans hVidPnTargetModeSet n’était pas valide.

Remarques

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

  1. Appelez pfnCreateNewModeInfo pour obtenir un pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE . La fonction pnfCreateNewModeInfo alloue la structure et remplit le membre ID avec un identificateur de mode cible nouvellement généré.
  2. Le membre Info de la structure D3DKMDT_VIDPN_TARGET_MODE est une structure D3DKMDT_VIDEO_SIGNAL_MODE . Renseignez cette structure avec des informations sur le mode.
  3. Appelez pfnAddMode pour ajouter le mode à un ensemble de modes cibles.
Le gestionnaire VidPN alloue une structure D3DKMDT_VIDPN_TARGET_MODE lorsque vous appelez pfnCreateNewModeInfo. Si vous ajoutez le mode décrit par cette structure à un ensemble de modes cibles, vous n’avez pas besoin de libérer explicitement la structure ; pfnAddMode le libère.

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

Le type de données D3DKMDT_HVIDPNTARGETMODESET 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_TARGET_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo