DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO fonction de rappel (d3dkmddi.h)
La fonction DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO retourne le premier descripteur de plage de fréquences dans un objet de jeu de plages de fréquences de surveillance 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 d’un objet de jeu de plages de fréquences de surveillance. Le pilote miniport d’affichage a obtenu précédemment 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 de retour
La fonction pfnAcquireFirstFrequencyRangeInfo retourne l’une des valeurs suivantes.
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | La fonction a retourné avec succès le premier descripteur de plage de fréquences. |
| STATUS_GRAPHICS_DATASET_IS_EMPTY | La fonction a réussi, mais il n’y avait pas de descripteurs 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équence de surveillance définie en appelant pfnAcquireFirstFrequencyRangeInfo, puis en effectuant une séquence d’appels à pfnAcquireNextFrequencyRangeInfo.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |