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 |