DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

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.