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