DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO fonction de rappel (d3dkmddi.h)

Article
02/23/2024

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

Syntaxe

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

Paramètres

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

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

Valeur retournée

La fonction pfnCreateNewModeInfo 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

La fonction pfnCreateNewModeInfo alloue une structure D3DKMDT_VIDPN_SOURCE_MODE , définit son membre Id sur un identificateur nouvellement généré et définit son membre Typesur D3DKMDT_RMT_UNINITIALIZED.

Après avoir appelé pfnCreateNewModeInfo pour obtenir une structure D3DKMDT_VIDPN_SOURCE_MODE, vous devez effectuer une des opérations suivantes, mais pas les deux :

Remplissez la structure et passez-la à pfnAddMode.
Libérez la structure en appelant pfnReleaseModeInfo.

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

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 (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Voir aussi

D3DKMDT_VIDPN_SOURCE_MODE

pfnAddMode

pfnReleaseModeInfo

Partager via