DXGKDDI_MONITORSOURCEMODESET_ADDMODE Rückruffunktion (d3dkmddi.h)
Die pfnAddMode--Funktion fügt einem angegebenen Monitorquellenmodussatzobjekt 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 Monitorquellmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireMonitorSourceModeSet- Funktion der Monitorschnittstelleabgerufen.
[in] pMonitorSourceModeInfo
Ein Zeiger auf eine D3DKMDT_MONITOR_SOURCE_MODE Struktur, die den Monitorquellmodus beschreibt. Der Display-Miniporttreiber hat diese Struktur zuvor durch Aufrufen pfnCreateNewModeInfoabgerufen.
Rückgabewert
Die pfnAddMode Funktion gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_NO_MEMORY | Fehler bei der Funktion, da sie nicht genügend Arbeitsspeicher zuordnen konnte. |
| STATUS_GRAPHICS_INVALID_MONITOR_SOURCE_MODE | Die in pMonitorSourceModeInfo bereitgestellten Informationen waren ungültig. |
| STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET | Das in hMonitorSourceModeSet bereitgestellte 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 bereitgestellte aktive Bereich war ungültig. |
| STATUS_GRAPHICS_INVALID_TOTAL_REGION | Die in pMonitorSourceModeInfo bereitgestellte Gesamtregion 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 bereitgestellte Bezeichner wird bereits für einen anderen Modus im Modussatz verwendet. |
| STATUS_GRAPHICS_RESOURCES_NOT_RELATED | Die struktur, auf die von pMonitorSourceModeInfo verwiesen wurde, wurde nicht erstellt, um den von hMonitorSourceModeSet angegebenen Modussatz zu ergänzen. |
Bemerkungen
Wenn pMonitorSourceModeInfo->Einstellung gleich D3DKMDT_MP_PREFERRED ist, wird der neu hinzugefügte Modus zum bevorzugten Modus des Modussatzes.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |