DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnAcquireNextModeInfo-Funktion gibt einen Deskriptor des nächsten Modus in einem angegebenen VidPN-Quellmodussatz für den aktuellen Modus zurück.

Syntax

DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpnsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppNextVidPnSourceModeInfo
)
{...}

Parameter

[in] hVidPnSourceModeSet

Ein Handle für ein VidPN-Quellmodus-Setobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireSourceModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[in] pVidPnSourceModeInfo

Ein Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE Struktur, die den aktuellen Modus beschreibt. Der Anzeigeminiporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnAcquireFirstModeInfo oder pfnAcquireNextModeInfo abgerufen.

[out] ppNextVidPnSourceModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_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_VIDPN_SOURCEMODESET Das in hVidPnSourceModeSet angegebene Handle war ungültig.

Hinweise

Wenn Sie die D3DKMDT_VIDPN_SOURCE_MODE-Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.

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

Der D3DKMDT_HVIDPNSOURCEMODESET 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_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnReleaseModeInfo