DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO fonction de rappel (d3dkmddi.h)

Article
02/26/2024

La fonction pfnAcquireNextModeInfo retourne un descripteur du mode suivant dans un mode source de moniteur spécifié défini, compte tenu du mode actuel.

Syntaxe

DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}

Paramètres

[in] hMonitorSourceModeSet

Handle d’un objet set en mode source monitor. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnAcquireMonitorSourceModeSet de l’interface Monitor.

[in] pMonitorSourceModeInfo

Pointeur vers une structure D3DKMDT_MONITOR_SOURCE_MODE qui décrit le mode actuel. Le pilote miniport d’affichage a précédemment obtenu ce pointeur en appelant pfnAcquireFirstModeInfo ou pfnAcquireNextModeInfo.

[out] ppNextMonitorSourceModeInfo

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

Valeur retournée

La fonction pfnAcquireNextModeInfo retourne l’une des valeurs suivantes :

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

Remarques

Une fois que vous avez terminé d’utiliser la structure D3DKMDT_MONITOR_SOURCE_MODE , vous devez libérer la structure en appelant pfnReleaseModeInfo.

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

Le type de données D3DKMDT_HMONITORSOURCEMODESET 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_MONITOR_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnReleaseModeInfo

Partager via