DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO Rückruffunktion (d3dkmddi.h)

2025-02-06

Die pfnAcquireFirstModeInfo Funktion gibt einen Deskriptor des ersten Modus in einem angegebenen VidPN-Quellmodussatz zurück.

Syntax

DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppFirstVidPnSourceModeInfo
)
{...}

Parameter

[in] hVidPnSourceModeSet

Ein Handle zu einem VidPN-Quellmodussatzobjekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireSourceModeSet- Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[out] ppFirstVidPnSourceModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE Struktur empfängt. Die Struktur enthält eine Vielzahl von Informationen zum Modus, einschließlich der ID, des Typs und des Renderingformats.

Rückgabewert

Die pfnAcquireFirstModeInfo Funktion gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Das in hVidPnSourceModeSet bereitgestellte Handle war ungültig.

Bemerkungen

Wenn Sie die D3DKMDT_VIDPN_SOURCE_MODE Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.

Sie können alle Modi aufzählen, die zu einem VidPN-Quellmodus-Set-Objekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextModeInfo.

Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp wird in D3dkmdt.hdefiniert.