DXGKDDI_VIDPN_CREATENEWTARGETMODESET Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnCreateNewTargetModeSet Funktion erstellt ein neues Zielmodus-Set-Objekt innerhalb eines angegebenen VidPN-Objekts.

Syntax

DXGKDDI_VIDPN_CREATENEWTARGETMODESET DxgkddiVidpnCreatenewtargetmodeset;

NTSTATUS DxgkddiVidpnCreatenewtargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phNewVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterace
)
{...}

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] VidPnTargetId

Eine ganze Zahl, die eines der Videoobjekte identifiziert, die dem VidPN-Objekt zugeordnet sind.

[out] phNewVidPnTargetModeSet

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

[out] ppVidPnTargetModeSetInterace

Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_VIDPNTARGETMODESET_INTERFACE Struktur empfängt. Die Struktur enthält Zeiger auf Funktionen, die der Anzeigeminiporttreiber aufrufen kann, um das Zielmodussatzobjekt zu prüfen und zu ändern.

Rückgabewert

Die pfnCreateNewTargetModeSet 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 Zielmodussatzobjekts erforderlichen Speicher nicht zuordnen.

Bemerkungen

Führen Sie die folgenden Schritte aus, um einem bestimmten Zielmodus in einer VidPN-Implementierung einen neuen Zielmodus zuzuweisen:

Rufen Sie pfnCreateNewTargetModeSet auf, um ein Handle zu einem neuen Zielmodussatzobjekt abzurufen. Dieses Zielmodus-Set-Objekt gehört zu einem bestimmten VidPN-Objekt, das Sie angeben.
Verwenden Sie die Funktionen der DXGK_VIDPNTARGETMODESET_INTERFACE-Struktur, um dem Zielmodussatzobjekt Modi hinzuzufügen.
Rufen Sie pfnAssignTargetModeSet auf, um den neuen Zielmodus einem bestimmten Ziel zuzuweisen.

Wenn Sie ein Handle durch Aufrufen von pfnCreateNewTargetModeSet abrufen und dann dieses Handle an pfnAssignTargetModeSetübergeben, müssen Sie das Handle nicht freigeben, indem Sie pfnReleaseTargetModeSetaufrufen.

Wenn Sie ein Handle durch Aufrufen pfnCreateNewTargetModeSet abrufen und sich dann entscheiden, den neuen Zielmodus einem Ziel nicht zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseTargetModeSetaufrufen.

Die Lebensdauer der DXGK_VIDPNTARGETEMODESET_INTERFACE Struktur, die in ppVidPnTargetModeSetInterface- 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_HVIDPNTARGETMODESET werden in D3dkmdt.hdefiniert.