DXGKDDI_VIDPN_CREATENEWTARGETMODESET Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnCreateNewTargetModeSet-Funktion erstellt ein neues Zielmodus-Set-Objekt in einem angegebenen VidPN-Objekt.

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 für ein VidPN-Objekt. Der VidPN-Manager hat dieses Handle zuvor für den Anzeige-Miniporttreiber bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.

[in] VidPnTargetId

Eine ganze Zahl, die eines der dem VidPN-Objekt zugeordneten Videoziele identifiziert.

[out] phNewVidPnTargetModeSet

Ein Zeiger auf eine Variable, die ein Handle für das neu erstellte Zielmodus-Setobjekt 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 Anzeige-Miniporttreiber aufrufen kann, um das Zielmodus-Setobjekt zu überprüfen und zu ändern.

Rückgabewert

Die PfnCreateNewTargetModeSet-Funktion gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN Das in hVidPn angegebene Handle war ungültig.
STATUS_NO_MEMORY Der VidPN-Manager konnte den zum Erstellen des neuen Zielmodusobjekts erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

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

  1. Rufen Sie pfnCreateNewTargetModeSet auf, um ein Handle für ein neues Zielmodus-Setobjekt abzurufen. Dieses Zielmodus-Set-Objekt gehört zu einem bestimmten VidPN-Objekt, das Sie angeben.
  2. Verwenden Sie die Funktionen der DXGK_VIDPNTARGETMODESET_INTERFACE-Struktur , um dem Zielmodus-Setobjekt Modi hinzuzufügen.
  3. Rufen Sie pfnAssignTargetModeSet auf, um den neuen Zielmodus zuzuweisen, der einem bestimmten Ziel festgelegt ist.
Wenn Sie ein Handle abrufen, indem Sie pfnCreateNewTargetModeSet aufrufen und dieses Handle dann an pfnAssignTargetModeSet übergeben, müssen Sie das Handle nicht freigeben, indem Sie pfnReleaseTargetModeSet aufrufen.

Wenn Sie ein Handle erhalten, indem Sie pfnCreateNewTargetModeSet aufrufen und dann entscheiden, den neuen Zielmodus nicht einem Ziel zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseTargetModeSet aufrufen.

Die Lebensdauer der in ppVidPnTargetModeSetInterface zurückgegebenen DXGK_VIDPNTARGETEMODESET_INTERFACE-Struktur gehört dem Betriebssystem. Mit diesem Besitzschema kann das Betriebssystem zur Laufzeit zu neueren Implementierungen wechseln, ohne clients der Schnittstelle zu unterbrechen.

Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNTARGETMODESET sind 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

VidPN-Zielmodus-Set-Schnittstelle

pfnAssignTargetModeSet

pfnReleaseTargetModeSet