DXGKDDI_VIDPNTARGETMODESET_ADDMODE Rückruffunktion (d3dkmddi.h)

  • Artikel

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-Setobjekt. Der Anzeigeminiporttreiber 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 Anzeigeminiporttreiber hat diese Struktur zuvor durch Aufrufen von pfnCreateNewModeInfo abgerufen.

Rückgabewert

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

Um einem Zielmodussatz einen Modus hinzuzufügen, führt der Anzeigeminiporttreiber die folgenden Schritte aus.

  1. 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 den Id-Member mit einem neu generierten Zielmodusbezeichner aus.
  2. Das Infoelement der D3DKMDT_VIDPN_TARGET_MODE-Struktur ist eine D3DKMDT_VIDEO_SIGNAL_MODE-Struktur . Füllen Sie diese Struktur mit Informationen zum Modus auf.
  3. Rufen Sie pfnAddMode auf, um den Modus einem Zielmodussatz hinzuzufügen.
Der VidPN-Manager weist eine D3DKMDT_VIDPN_TARGET_MODE-Struktur zu, wenn Sie pfnCreateNewModeInfo aufrufen. Wenn Sie den von dieser Struktur beschriebenen Modus einem Zielmodussatz hinzufügen, müssen Sie die Struktur nicht explizit freigeben. pfnAddMode gibt es frei.

Wenn Sie eine D3DKMDT_VIDPN_TARGET_MODE-Struktur erhalten, indem Sie pfnCreateNewModeInfo aufrufen und dann entscheiden, diesen Modus nicht einem Zielmodussatz hinzuzufügen, müssen Sie die Struktur explizit freigeben, indem Sie pfnReleaseModeInfo aufrufen.

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

pfnCreateNewModeInfo

pfnReleaseModeInfo