DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO Rückruffunktion (d3dkmddi.h)

  • Artikel

Die DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO-Funktion gibt den ersten Frequenzbereichsdeskriptor in einem angegebenen monitor frequency range set-Objekt zurück.

Syntax

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppFirstMonitorFrequencyRangeInfo
)
{...}

Parameter

[in] hMonitorFrequencyRangeSet

Ein Handle für ein Überwachungshäufigkeitsbereichssatzobjekt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der PfnGetMonitorFrequencyRangeSet-Funktion der Monitor-Schnittstelle abgerufen.

[out] ppFirstMonitorFrequencyRangeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_MONITOR_FREQUENCY_RANGE-Struktur empfängt.

Rückgabewert

Die PfnAcquireFirstFrequencyRangeInfo-Funktion gibt einen der folgenden Werte zurück.

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion hat erfolgreich den ersten Frequenzbereichsdeskriptor zurückgegeben.
STATUS_GRAPHICS_DATASET_IS_EMPTY Die Funktion war erfolgreich, aber es gab keine Frequenzbereichsdeskriptoren in der Gruppe.
STATUS_INVALID_PARAMETER Es wurde ein ungültiger Parameter angegeben.
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