DXGKDDI_VIDPNSOURCEMODESET_ADDMODE Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnAddMode-Funktion fügt einem angegebenen VidPN-Quellmodussatzobjekt einen VidPN-Quellmodus hinzu.

Syntax

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Parameter

[in] hVidPnSourceModeSet

Ein Handle für ein VidPN-Quellmodus-Setobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireSourceModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[in] pVidPnSourceModeInfo

Ein Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE Struktur, die den Quellmodus 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_SOURCEMODESET Das in hVidPnSourceModeSet angegebene Handle war ungültig.

Hinweise

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

Rufen Sie pfnCreateNewModeInfo auf, um einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur abzurufen. Die pnfCreateNewModeInfo-Funktion weist die Struktur zu, füllt das Id-Member mit einem neu generierten Quellmodusbezeichner aus und legt das Type-Element auf D3DKMDT_RMT_UNINITIALIZED fest.

Füllen Sie die D3DKMDT_VIDPN_SOURCE_MODE-Struktur (mit Ausnahme des Id-Members ) mit Informationen zum Modus, einschließlich des Typs und Des Formats des Modus.

Rufen Sie pfnAddMode auf, um den Modus einem Quellmodussatz hinzuzufügen.

Der VidPN-Manager weist eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur zu, wenn Sie pfnCreateNewModeInfo aufrufen. Wenn Sie den von dieser Struktur beschriebenen Modus einem Quellmodussatz hinzufügen, müssen Sie die Struktur nicht explizit freigeben. pfnAddMode gibt es frei.

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

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

pfnCreateNewModeInfo

pfnReleaseModeInfo