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 |