Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |