DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO Rückruffunktion (d3dkmddi.h)

Die pfnAcquireNextModeInfo-Funktion gibt einen Deskriptor des nächsten Modus in einem angegebenen Quellmodussatz des Monitors zurück, wenn der aktuelle Modus angegeben ist.

Syntax

DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}

Parameter

[in] hMonitorSourceModeSet

Ein Handle für ein Set-Objekt für den Monitorquellmodus. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireMonitorSourceModeSet-Funktion der Monitor-Schnittstelle abgerufen.

[in] pMonitorSourceModeInfo

Ein Zeiger auf eine D3DKMDT_MONITOR_SOURCE_MODE Struktur, die den aktuellen Modus beschreibt. Der Anzeige-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnAcquireFirstModeInfo oder pfnAcquireNextModeInfo abgerufen.

[out] ppNextMonitorSourceModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_MONITOR_SOURCE_MODE-Struktur empfängt, die den nächsten Modus beschreibt.

Rückgabewert

Die pfnAcquireNextModeInfo-Funktion gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	Das in hMonitorSourceModeSet angegebene Handle war ungültig.

Hinweise

Wenn Sie die Verwendung der D3DKMDT_MONITOR_SOURCE_MODE-Struktur abgeschlossen haben, müssen Sie die -Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.

Sie können alle Modi aufzählen, die zu einem bestimmten Set-Objekt des Überwachungsquellmodus gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextModeInfo ausführen.

Der datentyp D3DKMDT_HMONITORSOURCEMODESET wird in D3dkmdt.h definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

D3DKMDT_MONITOR_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnReleaseModeInfo