DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO Rückruffunktion (d3dkmddi.h)

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

Syntax

DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppPinnedVidPnSourceModeInfo
)
{...}

Parameter

[in] hVidPnSourceModeSet

Ein Handle für ein VidPN-Quellmodus-Setobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireSourceModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[out] ppPinnedVidPnSourceModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur empfängt. Die Struktur enthält eine Vielzahl von Informationen zum angehefteten Modus, einschließlich ID, Typ und Renderingformat. Wenn der von hVidPnSourceModeSet identifizierte Quellmodussatz 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 ist erfolgreich, indem sie eine der folgenden Aktionen ausführt: 1. Festlegen von ppPinnedVidPnSourceModeInfo auf die Adresse D3DKMDT_VIDPN_SOURCE_MODE Struktur, die den angehefteten Modus beschreibt. 2. Festlegen von ppPinnedVidPnSourceModeInfo auf NULL, um anzugeben, dass der Quellmodussatz keinen angehefteten Modus aufweist.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Das in hVidPnSourceModeSet angegebene Handle war ungültig.

Hinweise

Wenn Sie die verwendung der D3DKMDT_VIDPN_SOURCE_MODE-Struktur abgeschlossen haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.

Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp ist 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

D3DKMDT_VIDPN_SOURCE_MODE

pfnPinMode

pfnReleaseModeInfo