DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die pfnCreateNewModeInfo-Funktion gibt einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur zurück, die der Anzeigeminiporttreiber vor dem Aufruf von pfnAddMode auffü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 für ein VidPN-Quellmodus-Set-Objekt. Der Anzeige-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 zugeordnete 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 wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Das in hVidPnSourceModeSet angegebene Handle war ungültig.

Hinweise

Die pfnCreateNewModeInfo-Funktion ordnet eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur zu, legt deren Id-Member auf einen neu generierten Bezeichner und das Type-Element auf D3DKMDT_RMT_UNINITIALIZED fest.

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

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

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

Der D3DKMDT_HVIDPNSOURCEMODESET 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_SOURCE_MODE

pfnAddMode

pfnReleaseModeInfo

Freigeben über