DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO fonction de rappel (d3dkmddi.h)

Article
02/26/2024

La fonction pfnAcquireNextFrequencyRangeInfo retourne le descripteur de plage de fréquences suivant dans un ensemble de plages de fréquences de surveillance, compte tenu du descripteur de plage de fréquences actuel.

Syntaxe

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_FREQUENCY_RANGE_CONST pMonitorFrequencyRangeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppNextMonitorFrequencyRangeInfo
)
{...}

Paramètres

[in] hMonitorFrequencyRangeSet

Handle pour un objet défini sur la plage de fréquences du moniteur. Le pilote de miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnGetMonitorFrequencyRangeSet de l’interface monitor.

[in] pMonitorFrequencyRangeInfo

Pointeur vers une structure D3DKMDT_MONITOR_FREQUENCY_RANGE qui est le descripteur de plage de fréquences actuel. Le pilote de miniport d’affichage a précédemment obtenu ce pointeur en appelant pfnAcquireFirstFrequencyRangeInfo ou pfnAcquireNextFrequencyRangeInfo.

[out] ppNextMonitorFrequencyRangeInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure de D3DKMDT_MONITOR_FREQUENCY_RANGE qui est le descripteur de plage de fréquences suivant.

Valeur retournée

La fonction pfnAcquireNextFrequencyRangeInfo retourne l’une des valeurs suivantes.

Code de retour	Description
STATUS_SUCCESS	La fonction a correctement retourné le descripteur de plage de fréquences suivant.
STATUS_GRAPHICS_DATASET_IS_EMPTY	La fonction a réussi, mais il n’y avait plus de descripteurs de plage de fréquences dans l’ensemble.
STATUS_INVALID_PARAMETER	Un paramètre non valide a été fourni.
STATUS_INVALID_FREQUENCYRANGE	Le descripteur de plage de fréquence fourni dans pMonitorFrequencyRangeInfo n’était pas valide.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET	Le handle fourni dans hMonitorFrequencyRangeSet n’était pas valide.

Cette fonction peut également retourner d’autres codes d’erreur définis dans Ntstatus.h.

Remarques

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

Vous pouvez obtenir tous les descripteurs d’une plage de fréquences de surveillance définie en appelant pfnAcquireFirstFrequencyRangeInfo , puis en effectuant une séquence d’appels à pfnAcquireNextFrequencyRangeInfo.

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

Partager via