DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/26/2024

Die pfnCreateNewModeInfo-Funktion gibt einen Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur zurück, die der Anzeigeminiporttreiber vor dem Aufrufen von pfnAddMode auffüllt.

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-Setobjekt. Der Anzeigeminiporttreiber 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 wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Das in hVidPnTargetModeSet angegebene Handle war ungültig.

Hinweise

Die PfnCreateNewModeInfo-Funktion weist eine D3DKMDT_VIDPN_TARGET_MODE-Struktur zu und legt deren Id-Member auf einen neu generierten Bezeichner fest.

Nachdem Sie pfnCreateNewModeInfo aufgerufen haben, um eine D3DKMDT_VIDPN_TARGET_MODE-Struktur abzurufen, müssen Sie eine der folgenden Aktionen ausführen, aber nicht beide:

Füllen Sie das Infoelement der Struktur auf, und übergeben Sie die Struktur an pfnAddMode.
Geben Sie die Struktur frei, indem Sie pfnReleaseModeInfo aufrufen.

Wenn Sie eine D3DKMDT_VIDPN_TARGET_MODE-Struktur auffüllen, haben Sie die Möglichkeit, das id-Element zu überschreiben, das von pfnCreateNewModeInfo generiert und festgelegt wurde. Wenn Sie jedoch das Id-Member einer D3DKMDT_VIDPN_TARGET_MODE-Struktur überschreiben, müssen Sie die ID-Member aller D3DKMDT_VIDPN_TARGET_MODE Strukturen überschreiben, die Sie von pfnCreateNewModeInfo erhalten. Es sei denn, Sie haben einen bestimmten Grund für das Überschreiben der ID-Member (z. B. Nachverfolgen von Zielmodi mit Ihrem eigenen Nummerierungsschema), sollten Sie sie wie von pfnCreateNewModeInfo festgelegt lassen.

Der D3DKMDT_HVIDPNTARGETMODESET 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_TARGET_MODE

pfnAddMode

pfnReleaseModeInfo

Freigeben über