DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO Rückruffunktion (d3dkmddi.h)

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

Syntax

DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpntargetmodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppFirstVidPnTargetModeInfo
)
{...}

Parameter

[in] hVidPnTargetModeSet

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

[out] ppFirstVidPnTargetModeInfo

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 über den Zielmodus, einschließlich der ID und der Merkmale des Videosignals.

Rückgabewert

Die PfnAcquireFirstModeInfo-Funktion gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Das in hVidPnTargetModeSet angegebene Handle war ungültig.

Hinweise

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

Sie können alle Modi auflisten, die zu einem VidPN-Zielmodus-Setobjekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextModeInfo ausführen.

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_TARGET_MODE

pfnAcquireNextModeInfo

pfnReleaseModeInfo