DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die pfnAcquireNextFrequencyRangeInfo-Funktion gibt den nächsten Frequenzbereichsdeskriptor in einem Monitorfrequenzbereich zurück, der unter Berücksichtigung des aktuellen Frequenzbereichsdeskriptor festgelegt 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 Überwachungshäufigkeitsbereichssatzobjekt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der PfnGetMonitorFrequencyRangeSet-Funktion der Monitorschnittstelle abgerufen.

[in] pMonitorFrequencyRangeInfo

Ein Zeiger auf eine D3DKMDT_MONITOR_FREQUENCY_RANGE-Struktur , bei der es sich um den aktuellen Frequenzbereichsdeskriptor handelt. Der Anzeige-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnAcquireFirstFrequencyRangeInfo oder pfnAcquireNextFrequencyRangeInfo abgerufen.

[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 weiteren Frequenzbereichsdeskriptoren in der Gruppe.
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 angegebene Handle war ungültig.

Diese Funktion gibt möglicherweise auch andere Fehlercodes zurück, die in "Ntstatus.h" definiert sind.

Hinweise

Wenn Sie die Verwendung der D3DKMDT_MONITOR_FREQUENCY_RANGE-Struktur abgeschlossen haben, müssen Sie die -Struktur freigeben, indem Sie pfnReleaseFrequencyRangeInfo aufrufen.

Sie können alle Deskriptoren in einem festgelegten Überwachungshäufigkeitsbereich abrufen, indem Sie pfnAcquireFirstFrequencyRangeInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextFrequencyRangeInfo ausführen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Freigeben über