DXGKDDI_VIDPN_ACQUIRETARGETMODESET Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAcquireTargetModeSet--Funktion gibt ein Handle an ein bestimmtes Zielmodussatzobjekt zurück, das in einem angegebenen VidPN-Objekt enthalten ist.

Syntax

DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;

NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}

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

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

[out] ppVidPnTargetModeSetInterface

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 pfnAcquireTargetModeSet 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_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	Der in VidPnTargetId angegebene Bezeichner war ungültig.

Bemerkungen

VidPN-Ziel-IDs werden vom Anzeigeminiporttreiber zugewiesen. DxgkDdiQueryChildRelations, implementiert vom Display Miniport-Treiber, gibt ein Array von DXGK_CHILD_DESCRIPTOR Strukturen zurück, die jeweils einen Bezeichner enthalten.

Wenn Sie das Objekthandle für den Zielmodussatz abgeschlossen haben, müssen Sie das Handle freigeben, indem Sie pfnReleaseTargetModeSetaufrufen. Zielmodussatzobjekte werden gezählt. Wenn Sie also mehrere Male ein Handle abrufen, müssen Sie es beliebig oft freigeben.

Die Lebensdauer der DXGK_VIDPNTARGETMODESET_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.

Der D3DDDI_VIDEO_PRESENT_TARGET_ID Datentyp wird in D3dukmdt.hdefiniert.

Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNTARGETMODESET werden in D3dkmdt.hdefiniert.