DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO-Funktion gibt den ersten Frequenzbereichsdeskriptor in einem angegebenen Monitorfrequenzbereichssatzobjekt 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 Monitorhäufigkeitsbereich-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetMonitorFrequencyRangeSet Funktion der Monitor-Schnittstelleabgerufen.

[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 Häufigkeitsbereichsdeskriptoren in der Gruppe.
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter angegeben.
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