DXGKDDI_VIDPN_ACQUIRESOURCEMODESET Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

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

Syntax

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [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] phVidPnSourceModeSet

Ein Zeiger auf eine Variable, die ein Handle für das angeforderte 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 funktion pfnAcquireSourceModeSet 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_SOURCE	Der in VidPnSourceId angegebene Bezeichner war ungültig.

Bemerkungen

VidPN-Quellbezeichner werden vom Betriebssystem zugewiesen. DxgkDdiStartDevice, implementiert vom Display Miniport-Treiber, gibt die Anzahl N der vom Displayadapter unterstützten Videoquellen zurück. Anschließend weist das Betriebssystem Bezeichner 0, 1, 2, ... N - 1.

Wenn Sie das Objekthandle für den Quellmodussatz abgeschlossen haben, müssen Sie das Handle freigeben, indem Sie pfnReleaseSourceModeSetaufrufen. Für den Quellmodus festgelegte Objekte werden gezählt. Wenn Sie also mehrmals ein Handle abrufen, müssen Sie es beliebig oft freigeben.

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.

Der D3DDDI_VIDEO_PRESENT_SOURCE_ID Datentyp wird in D3dukmdt.hdefiniert.

Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNSOURCEMODESET werden in D3dkmdt.hdefiniert.