DXGKDDI_VIDPNSOURCEMODESET_ADDMODE Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAddMode-Funktion fügt einem angegebenen VidPN-Quellmodussatzobjekt einen VidPN-Quellmodus hinzu.

Syntax

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

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.

[in] pVidPnSourceModeInfo

Ein Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE Struktur, die den Quellmodus beschreibt. Der Display-Miniporttreiber hat diese Struktur zuvor durch Aufrufen pfnCreateNewModeInfoabgerufen.

Rückgabewert

Die pfnAddMode 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

Zum Hinzufügen eines Modus zu einem Quellmodussatz führt der Miniporttreiber die folgenden Schritte aus.

Rufen Sie pfnCreateNewModeInfo auf, um einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur abzurufen. Die pnfCreateNewModeInfo-Funktion weist die Struktur zu, füllt die Id Member mit einem neu generierten Quellmodusbezeichner aus und legt den Type Member auf D3DKMDT_RMT_UNINITIALIZEDfest.

Füllen Sie die D3DKMDT_VIDPN_SOURCE_MODE Struktur (mit Ausnahme der ID Member) mit Informationen zum Modus, einschließlich Typ und Format des Modus.

Rufen Sie pfnAddMode- auf, um den Modus einem Quellmodussatz hinzuzufügen.

Der VidPN-Manager weist eine D3DKMDT_VIDPN_SOURCE_MODE Struktur zu, wenn Sie pfnCreateNewModeInfoaufrufen. Wenn Sie den von dieser Struktur beschriebenen Modus zu einem Quellmodussatz hinzufügen, müssen Sie die Struktur nicht explizit freigeben. pfnAddMode veröffentlicht sie.

Wenn Sie eine D3DKMDT_VIDPN_SOURCE_MODE Struktur abrufen, indem Sie pfnCreateNewModeInfo aufrufen und sich dann entscheiden, diesen Modus keinem Quellmodussatz hinzuzufügen, müssen Sie die Struktur explizit freigeben, indem Sie pfnReleaseModeInfoaufrufen.

Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp wird in D3dkmdt.hdefiniert.