DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnCreateNewModeInfo-Funktion gibt einen Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur zurück, die der Anzeigeminiporttreiber auffüllt, bevor pfnAddModeaufgerufen wird.

Syntax

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

Parameter

[in] hVidPnTargetModeSet

Ein Handle für ein VidPN-Zielmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireTargetModeSet- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle abgerufen.

[out] ppNewVidPnTargetModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine vom VidPN-Manager zugewiesene D3DKMDT_VIDPN_TARGET_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_TARGETMODESET	Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig.

Bemerkungen

Die pfnCreateNewModeInfo--Funktion weist eine D3DKMDT_VIDPN_TARGET_MODE Struktur zu und legt dessen ID Member auf einen neu generierten Bezeichner fest.

Nachdem Sie pfnCreateNewModeInfo aufgerufen haben, um eine D3DKMDT_VIDPN_TARGET_MODE Struktur zu erhalten, müssen Sie eine der folgenden Aktionen ausführen:

Füllen Sie das Info- Element der Struktur auf, und übergeben Sie die Struktur an pfnAddMode.
Geben Sie die Struktur frei, indem Sie pfnReleaseModeInfoaufrufen.

Wenn Sie eine D3DKMDT_VIDPN_TARGET_MODE Struktur auffüllen, haben Sie die Möglichkeit, das Id Element zu überschreiben, das von pfnCreateNewModeInfogeneriert und festgelegt wurde. Wenn Sie jedoch das Id- Mitglied einer beliebigen D3DKMDT_VIDPN_TARGET_MODE Struktur überschreiben, müssen Sie die ID-Member aller D3DKMDT_VIDPN_TARGET_MODE Strukturen überschreiben, die Sie aus pfnCreateNewModeInfoabrufen. Wenn Sie keinen bestimmten Grund für das Überschreiben der ID-Member haben (z. B. Das Nachverfolgen von Zielmodi mit Ihrem eigenen Nummerierungsschema), sollten Sie sie gemäß pfnCreateNewModeInfofestlegen.

Der D3DKMDT_HVIDPNTARGETMODESET Datentyp wird in D3dkmdt.hdefiniert.