DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction pfnAcquireNextModeInfo retourne un descripteur du mode suivant dans un jeu de mode cible VidPN spécifié, en fonction du mode actuel.

Syntaxe

DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpntargetmodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in]  IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppNextVidPnTargetModeInfo
)
{...}

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 actuel. Le pilote display miniport a précédemment obtenu ce pointeur en appelant pfnAcquireFirstModeInfo ou pfnAcquireNextModeInfo.

[out] ppNextVidPnTargetModeInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE qui décrit le mode suivant.

Valeur de retour

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

Lorsque vous avez terminé d’utiliser la structure D3DKMDT_VIDPN_TARGET_MODE, vous devez libérer la structure en appelant pfnReleaseModeInfo.

Vous pouvez énumérer tous les modes appartenant à un objet défini en mode cible particulier en appelant pfnAcquireFirstModeInfo, puis en effectuant une séquence d’appels à pfnAcquireNextModeInfo.

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