DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO Rückruffunktion (d3dkmddi.h)
Die pfnAcquireNextModeInfo Funktion gibt einen Deskriptor des nächsten Modus in einem angegebenen Monitorquellmodussatz 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 Monitorquellmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireMonitorSourceModeSet- Funktion der Monitorschnittstelleabgerufen.
[in] pMonitorSourceModeInfo
Ein Zeiger auf eine D3DKMDT_MONITOR_SOURCE_MODE Struktur, die den aktuellen Modus beschreibt. Der Display-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen pfnAcquireFirstModeInfo oder pfnAcquireNextModeInfoabgerufen.
[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 war erfolgreich. |
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET | Das in hMonitorSourceModeSet- bereitgestellte Handle war ungültig. |
Bemerkungen
Wenn Sie die D3DKMDT_MONITOR_SOURCE_MODE Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.
Sie können alle Modi aufzählen, die zu einem bestimmten Überwachungsquellenmodus-Set-Objekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextModeInfo.
Der D3DKMDT_HMONITORSOURCEMODESET Datentyp wird in D3dkmdt.hdefiniert.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows Vista |
Zielplattform- | Desktop |
Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
IRQL- | PASSIVE_LEVEL |