DXGKDDI_VIDPN_ACQUIRETARGETMODESET Rückruffunktion (d3dkmddi.h)

Die pfnAcquireTargetModeSet-Funktion gibt ein Handle an ein bestimmtes Zielmodus-Setobjekt 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 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] phVidPnTargetModeSet

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

Rückgabewert

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

Hinweise

VidPN-Zielbezeichner werden vom Anzeige-Miniporttreiber zugewiesen. DxgkDdiQueryChildRelations, das vom Anzeigeminiporttreiber implementiert wird, gibt ein Array von DXGK_CHILD_DESCRIPTOR-Strukturen zurück, von denen jede einen Bezeichner enthält.

Wenn Sie die Verwendung des Objekthandles für das Festlegen des Zielmodus abgeschlossen haben, müssen Sie das Handle freigeben, indem Sie pfnReleaseTargetModeSet aufrufen. Zielmodus-Set-Objekte werden gezählt. Wenn Sie also ein Handle mehrmals abrufen, müssen Sie es genauso oft freigeben.

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

Der D3DDDI_VIDEO_PRESENT_TARGET_ID Datentyp ist in D3dukmdt.h definiert.

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

pfnCreateNewTargetModeSet

pfnReleaseTargetModeSet