DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO fonction de rappel (d3dkmddi.h)

  • Article

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