DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO Rückruffunktion (d3dkmddi.h)

2025-02-06

Die pfnCreateNewModeInfo-Funktion gibt einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE Struktur zurück, die der Anzeigeminiporttreiber vor dem Aufrufen pfnAddModeauffüllt.

Syntax

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

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] ppNewVidPnSourceModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine vom VidPN-Manager zugewiesene D3DKMDT_VIDPN_SOURCE_MODE Struktur empfängt.

Rückgabewert

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

Die pfnCreateNewModeInfo--Funktion weist eine D3DKMDT_VIDPN_SOURCE_MODE Struktur zu, legt dessen ID Element auf einen neu generierten Bezeichner fest und legt dessen Type Member auf D3DKMDT_RMT_UNINITIALIZEDfest.

Nachdem Sie pfnCreateNewModeInfo aufgerufen haben, um eine D3DKMDT_VIDPN_SOURCE_MODE Struktur abzurufen, müssen Sie eine der folgenden Aktionen ausführen:

Füllen Sie die Struktur auf, und übergeben Sie sie an pfnAddMode.
Geben Sie die Struktur frei, indem Sie pfnReleaseModeInfoaufrufen.

Wenn Sie eine D3DKMDT_VIDPN_SOURCE_MODE Struktur auffüllen, haben Sie die Möglichkeit, das ID- element zu überschreiben, das generiert und durch pfnCreateNewModeInfofestgelegt wurde. Wenn Sie jedoch das Id- Mitglied einer beliebigen D3DKMDT_VIDPN_SOURCE_MODE Struktur überschreiben, müssen Sie die ID-Member aller D3DKMDT_VIDPN_SOURCE_MODE Strukturen, die Sie aus pfnCreateNewModeInfoabrufen, überschreiben. Es sei denn, Sie haben einen bestimmten Grund zum Überschreiben der ID Member (z. B. das Nachverfolgen von Quellmodi mit Ihrem eigenen Nummerierungsschema), sollten Sie sie wie pfnCreateNewModeInfofestlegen lassen.

Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp wird in D3dkmdt.hdefiniert.