DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnAcquireNextModeInfo-Funktion gibt einen Deskriptor des nächsten Modus in einem angegebenen VidPN-Zielmodussatz im aktuellen Modus zurück.

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-Setobjekt. Der Anzeigeminiporttreiber 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 Anzeigeminiporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnAcquireFirstModeInfo oder pfnAcquireNextModeInfo abgerufen.

[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 wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Das in hVidPnTargetModeSet angegebene Handle war ungültig.

Hinweise

Wenn Sie die Verwendung der D3DKMDT_VIDPN_TARGET_MODE-Struktur abgeschlossen haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.

Sie können alle Modi auflisten, die zu einem bestimmten Zielmodussatzobjekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextModeInfo ausführen.

Der D3DKMDT_HVIDPNTARGETMODESET Datentyp ist 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

Weitere Informationen

D3DKMDT_VIDPN_TARGET_MODE

pfnAcquireFirstModeInfo

pfnReleaseModeInfo