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 VidPN-Zielmodussatz zurück, wenn der aktuelle Modus angegeben ist.
Syntax
DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpntargetmodesetAcquirenextmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirenextmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppNextVidPnTargetModeInfo
)
{...}
Parameter
[in] hVidPnTargetModeSet
Ein Handle für ein VidPN-Zielmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireTargetModeSet- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle abgerufen.
[in] pVidPnTargetModeInfo
Ein Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur, die den aktuellen Modus beschreibt. Der Display-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen pfnAcquireFirstModeInfo oder pfnAcquireNextModeInfoabgerufen.
[out] ppNextVidPnTargetModeInfo
Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_TARGET_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_VIDPN_TARGETMODESET | Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig. |
Bemerkungen
Wenn Sie die D3DKMDT_VIDPN_TARGET_MODE Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.
Sie können alle Modi aufzählen, die zu einem bestimmten Zielmodus-Set-Objekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextModeInfo.
Der D3DKMDT_HVIDPNTARGETMODESET 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 |