DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO fonction de rappel (d3dkmddi.h)

Article
02/23/2024

La fonction DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO retourne le premier descripteur de plage de fréquences dans un objet défini sur la plage de fréquences du moniteur spécifié.

Syntaxe

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppFirstMonitorFrequencyRangeInfo
)
{...}

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.

[out] ppFirstMonitorFrequencyRangeInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_MONITOR_FREQUENCY_RANGE .

Valeur retournée

La fonction pfnAcquireFirstFrequencyRangeInfo retourne l’une des valeurs suivantes.

Code de retour	Description
STATUS_SUCCESS	La fonction a correctement retourné le premier descripteur de plage de fréquences.
STATUS_GRAPHICS_DATASET_IS_EMPTY	La fonction a réussi, mais il n’y avait aucun descripteur de plage de fréquences dans l’ensemble.
STATUS_INVALID_PARAMETER	Un paramètre non valide a été fourni.
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