DXGKDDI_VIDPN_CREATENEWSOURCEMODESET Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnCreateNewSourceModeSet Funktion erstellt ein neues Quellmodussatzobjekt in einem angegebenen VidPN-Objekt.

Syntax

DXGKDDI_VIDPN_CREATENEWSOURCEMODESET DxgkddiVidpnCreatenewsourcemodeset;

NTSTATUS DxgkddiVidpnCreatenewsourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phNewVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Parameter

[in] hVidPn

Ein Handle zu einem VidPN-Objekt. Der VidPN-Manager hat diesem Handle zuvor den Miniporttreiber angezeigt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPnoder DxgkDdiRecommendFunctionalVidPnaufruft.

[in] VidPnSourceId

Eine ganze Zahl, die eine der Videoquellen identifiziert, die dem VidPN-Objekt zugeordnet sind.

[out] phNewVidPnSourceModeSet

Ein Zeiger auf eine Variable, die ein Handle für das neu erstellte Quellmodussatzobjekt empfängt.

[out] ppVidPnSourceModeSetInterface

Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_VIDPNSOURCEMODESET_INTERFACE-Struktur empfängt. Die Struktur enthält Zeiger auf Funktionen, die der Anzeigeminiporttreiber aufrufen kann, um das Objekt für den Quellmodussatz zu prüfen und zu ändern.

Rückgabewert

Die pfnCreateNewSourceModeSet Funktion gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_GRAPHICS_INVALID_VIDPN	Der in hVidPn bereitgestellte Handle war ungültig.
STATUS_NO_MEMORY	Der VidPN-Manager konnte den zum Erstellen des neuen Quellmodussatzobjekts erforderlichen Arbeitsspeicher nicht zuordnen.

Bemerkungen

Führen Sie die folgenden Schritte aus, um einen neuen Quellmodus zuzuweisen, der auf eine bestimmte Quelle in einem VidPN festgelegt ist:

Rufen Sie pfnCreateNewSourceModeSet auf, um ein Handle für ein neues Quellmodussatzobjekt abzurufen. Dieses Objekt für den Quellmodussatz gehört zu einem bestimmten von Ihnen angegebenen VidPN-Objekt.
Verwenden Sie die Funktionen der DXGK_VIDPNSOURCEMODESET_INTERFACE-Schnittstelle, um dem Quellmodussatzobjekt Modi hinzuzufügen.
Rufen Sie pfnAssignSourceModeSet- auf, um den neuen Quellmodus einer bestimmten Quelle zuzuweisen.

Wenn Sie ein Handle abrufen, indem Sie pfnCreateNewSourceModeSet aufrufen und dieses Handle dann an pfnAssignSourceModeSetübergeben, müssen Sie das Handle nicht freigeben, indem Sie pfnReleaseSourceModeSetaufrufen.

Wenn Sie ein Handle durch Aufrufen pfnCreateNewSourceModeSet abrufen und sich dann entscheiden, den neuen Quellmodus einer Quelle nicht zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseSourceModeSetaufrufen.

Die Lebensdauer der DXGK_VIDPNSOURCEMODESET_INTERFACE Struktur, die in ppVidPnSourceModeSetInterface- zurückgegeben wird, gehört dem Betriebssystem. Mit diesem Besitzerschema kann das Betriebssystem zur Laufzeit zu neueren Implementierungen wechseln, ohne clients der Schnittstelle zu unterbrechen.

Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNSOURCEMODESET werden in D3dkmdt.hdefiniert.