DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO Rückruffunktion (d3dkmddi.h)

Artikel
06.02.2025

Die pfnAcquirePinnedModeInfo Funktion gibt einen Deskriptor des angehefteten Modus in einem angegebenen VidPN-Zielmodussatz zurück.

Syntax

DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppPinnedVidPnTargetModeInfo
)
{...}

Parameter

[in] hVidPnTargetModeSet

Ein Handle für ein VidPN-Zielmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireTargetModeSet- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle abgerufen.

[out] ppPinnedVidPnTargetModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur empfängt. Die Struktur enthält eine Vielzahl von Informationen zum angehefteten Modus, einschließlich der ID- und Videosignaleigenschaften. Wenn der durch hVidPnTargetModeSet identifizierte Zielmodus keinen angehefteten Modus aufweist, empfängt diese Variable einen NULL- Zeiger.

Rückgabewert

Die pfnAcquirePinnedModeInfo Funktion gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich, indem Sie eine der folgenden Aktionen ausführen: 1. Festlegen von ppPinnedVidPnTargetModeInfo auf die Adresse D3DKMDT_VIDPN_TARGET_MODE Struktur, die den angehefteten Modus beschreibt. 2. Festlegen von ppPinnedVidPnTargetModeInfo auf NULL, um anzugeben, dass der festgelegte Zielmodus keinen angehefteten Modus aufweist.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig.

Bemerkungen

Wenn Sie die D3DKMDT_VIDPN_TARGET_MODE Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.

Der D3DKMDT_HVIDPNTARGETMODESET Datentyp wird in D3dkmdt.hdefiniert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

D3DKMDT_VIDPN_TARGET_MODE

pfnPinMode-

pfnReleaseModeInfo

Freigeben über