DXGKDDI_MONITORSOURCEMODESET_ACQUIREFIRSTMODEINFO Rückruffunktion (d3dkmddi.h)

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

Syntax

DXGKDDI_MONITORSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiMonitorsourcemodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

Parameter

[in] hMonitorSourceModeSet

Ein Handle für ein Monitorquellmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireMonitorSourceModeSet- Funktion der Monitorschnittstelleabgerufen.

[out] ppFirstMonitorSourceModeInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_MONITOR_SOURCE_MODE Struktur empfängt. Die Struktur enthält eine Vielzahl von Informationen zum Quellmodus des Monitors, einschließlich der ID und der Videosignaleigenschaften.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	Das in hMonitorSourceModeSet bereitgestellte Handle war ungültig.

Bemerkungen

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

Sie können alle Modi aufzählen, die zu einem VidPN-Überwachungsmodus-Set-Objekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextModeInfo.

Der D3DKMDT_HMONITORSOURCEMODESET 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_MONITOR_SOURCE_MODE

pfnAcquireNextModeInfo

pfnReleaseModeInfo