DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction pfnCreateNewModeInfo retourne un pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE que le pilote de miniport d’affichage remplit avant d’appeler pfnAddMode.

Syntaxe

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

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.

[out] ppNewVidPnTargetModeInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE allouée par le gestionnaire VidPN.

Valeur de retour

La fonction pfnCreateNewModeInfo retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Le handle fourni dans hVidPnTargetModeSet n’était pas valide.

Remarques

La fonction pfnCreateNewMode Info alloue une structure D3DKMDT_VIDPN_TARGET_MODE et définit son id membre sur un identificateur nouvellement généré.

Après avoir appelé pfnCreateNewModeInfo pour obtenir une structure D3DKMDT_VIDPN_TARGET_MODE, vous devez en effectuer une, mais pas les deux, des éléments suivants :

Remplissez le membre Info de la structure et transmettez la structure à pfnAddMode.
Relâchez la structure en appelant pfnReleaseModeInfo.

Lorsque vous remplissez une structure D3DKMDT_VIDPN_TARGET_MODE, vous avez la possibilité de remplacer le membre ID généré et défini par pfnCreateNewModeInfo. Toutefois, si vous remplacez le membre Id d’une structure de D3DKMDT_VIDPN_TARGET_MODE, vous devez remplacer les membres Id de toutes les structures D3DKMDT_VIDPN_TARGET_MODE obtenues à partir de pfnCreateNewModeInfo. Sauf si vous avez une raison spécifique de remplacer les membres ID (par exemple, le suivi des modes cibles avec votre propre schéma de numérotation), vous devez les laisser définis par pfnCreateNewModeInfo.

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