DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO Rückruffunktion (d3dkmddi.h)
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 |