DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO Rückruffunktion (d3dkmddi.h)

Die pfnAcquirePreferredModeInfo gibt einen Deskriptor des bevorzugten Modus in einem angegebenen Set-Objekt für den Monitorquellmodus zurück.

Syntax

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo(
  [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 bevorzugten Monitorquellmodus, einschließlich der ID und des Videosignals.

Rückgabewert

Die pfnAcquirePreferredModeInfo Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat erfolgreich einen Deskriptor des bevorzugten Modus zurückgegeben.
STATIS_GRAPHICS_NO_PREFERRED_MODE	Die Funktion war erfolgreich, aber der angegebene Monitorquellmodus hat keinen bevorzugten Modus.
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.

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