DXGKDDI_MONITORSOURCEMODESET_ADDMODE Rückruffunktion (d3dkmddi.h)

Die pfnAddMode-Funktion fügt einem angegebenen Monitorquellenmodus-Setobjekt einen Monitorquellmodus hinzu.

Syntax

DXGKDDI_MONITORSOURCEMODESET_ADDMODE DxgkddiMonitorsourcemodesetAddmode;

NTSTATUS DxgkddiMonitorsourcemodesetAddmode(
  [in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in] IN_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo
)
{...}

Parameter

[in] hMonitorSourceModeSet

Ein Handle für ein Set-Objekt für den Monitorquellmodus. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireMonitorSourceModeSet-Funktion der Monitor-Schnittstelle abgerufen.

[in] pMonitorSourceModeInfo

Ein Zeiger auf eine D3DKMDT_MONITOR_SOURCE_MODE Struktur, die den Quellmodus des Monitors beschreibt. Der Anzeige-Miniporttreiber hat diese Struktur zuvor durch Aufrufen von pfnCreateNewModeInfo abgerufen.

Rückgabewert

Die pfnAddMode-Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
STATUS_NO_MEMORY	Die Funktion ist fehlgeschlagen, weil sie nicht genügend Arbeitsspeicher zuweisen konnte.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCE_MODE	Die in pMonitorSourceModeInfo bereitgestellten Informationen waren ungültig.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	Das in hMonitorSourceModeSet angegebene Handle war ungültig.
STATUS_GRAPHICS_INVALID_FREQUENCY	Die in pMonitorSourceModeInfo bereitgestellten Häufigkeitsinformationen waren ungültig.
STATUS_GRAPHICS_INVALID_ACTIVE_REGION	Der in pMonitorSourceModeInfo angegebene aktive Bereich war ungültig.
STATUS_GRAPHICS_INVALID_TOTAL_REGION	Die in pMonitorSourceModeInfo bereitgestellte Region insgesamt war ungültig.
STATUS_GRAPHICS_MODE_ALREADY_IN_MODE_SET	Der Modussatz enthält bereits einen Modus, der mit dem in pMonitorSourceModeInfo bereitgestellten Modus identisch ist.
STATUS_GRAPHICS_MODE_ID_MUST_BE_UNIQUE	Der in pMonitorSourceModeInfo-Id> angegebene Bezeichner wird bereits für einen anderen Modus in der Modusgruppe verwendet.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED	Die Struktur, auf die von pMonitorSourceModeInfo verwiesen wird, wurde nicht erstellt, um dem durch hMonitorSourceModeSet angegebenen Modussatz zu hinzufügen.

Hinweise

Wenn pMonitorSourceModeInfo-Preference> gleich D3DKMDT_MP_PREFERRED ist, wird der neu hinzugefügte Modus zum bevorzugten Modus des Modussatzes.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

pfnCreateNewModeInfo