DXGKDDI_VIDPNTARGETMODESET_ADDMODE Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAddMode--Funktion fügt einem angegebenen VidPN-Zielmodussatzobjekt einen VidPN-Zielmodus hinzu.

Syntax

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

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.

[in] pVidPnTargetModeInfo

Ein Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur, die den Zielmodus 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_TARGETMODESET	Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig.

Bemerkungen

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

Rufen Sie pfnCreateNewModeInfo auf, um einen Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur abzurufen. Die pnfCreateNewModeInfo-Funktion weist die Struktur zu und füllt die ID Member mit einem neu generierten Zielmodusbezeichner.
Das Info- Element der D3DKMDT_VIDPN_TARGET_MODE Struktur ist eine D3DKMDT_VIDEO_SIGNAL_MODE Struktur. Füllen Sie diese Struktur mit Informationen zum Modus auf.
Rufen Sie pfnAddMode- auf, um den Modus einem Zielmodussatz hinzuzufügen.

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

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

Der D3DKMDT_HVIDPNTARGETMODESET Datentyp wird in D3dkmdt.hdefiniert.