DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAcquireNextFrequencyRangeInfo Funktion gibt den nächsten Frequenzbereichsdeskriptor in einem Monitorfrequenzbereichssatz zurück, wobei der aktuelle Frequenzbereichsdeskriptor angegeben ist.

Syntax

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
)
{...}

Parameter

[in] hMonitorFrequencyRangeSet

Ein Handle für ein Monitorhäufigkeitsbereich-Set-Objekt. Der Display-Miniport-Treiber hat dieses Handle zuvor durch Aufrufen der pfnGetMonitorFrequencyRangeSet Funktion der Monitor Interfaceabgerufen.

[in] pMonitorFrequencyRangeInfo

Ein Zeiger auf eine D3DKMDT_MONITOR_FREQUENCY_RANGE Struktur, die der aktuelle Frequenzbereichsdeskriptor ist. Der Display-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen pfnAcquireFirstFrequencyRangeInfo oder pfnAcquireNextFrequencyRangeInfoabgerufen.

[out] ppNextMonitorFrequencyRangeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_MONITOR_FREQUENCY_RANGE Struktur empfängt, die der nächste Frequenzbereichsdeskriptor ist.

Rückgabewert

Die pfnAcquireNextFrequencyRangeInfo Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat erfolgreich den nächsten Frequenzbereichsdeskriptor zurückgegeben.
STATUS_GRAPHICS_DATASET_IS_EMPTY	Die Funktion war erfolgreich, aber es gab keine Frequenzbereichsdeskriptoren im Satz.
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter angegeben.
STATUS_INVALID_FREQUENCYRANGE	Der in pMonitorFrequencyRangeInfo angegebene Frequenzbereichsdeskriptor war ungültig.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET	Das in hMonitorFrequencyRangeSet bereitgestellte Handle war ungültig.

Diese Funktion gibt möglicherweise auch andere Fehlercodes zurück, die in ntstatus.hdefiniert sind.

Bemerkungen

Wenn Sie die D3DKMDT_MONITOR_FREQUENCY_RANGE Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseFrequencyRangeInfoaufrufen.

Sie können alle Deskriptoren in einem Monitorfrequenzbereich abrufen, der festgelegt wird, indem Sie pfnAcquireFirstFrequencyRangeInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextFrequencyRangeInfo.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL-	PASSIVE_LEVEL

Freigeben über