DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO Rückruffunktion (d3dkmddi.h)

  • Artikel

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