Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die GetOverlayColorControls Funktion ruft Farbsteuerelementeinstellungen für die angegebene Überlagerung ab.
Syntax
PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;
HRESULT Pfnd3dddiGetoverlaycolorcontrols(
HANDLE hDevice,
D3DDDIARG_GETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in, out]
Ein Zeiger auf eine D3DDDIARG_GETOVERLAYCOLORCONTROLS Struktur, die Parameter zum Abrufen der Farbsteuerungseinstellungen einer Überlagerung beschreibt.
Rückgabewert
GetOverlayColorControls gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Einstellungen für die Farbsteuerung wurden erfolgreich abgerufen. |
| E_INVALIDARG | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
| E_OUTOFMEMORY | GetOverlayColorControls konnte den erforderlichen Speicher für den Abschluss nicht zuordnen. |
Bemerkungen
Die Microsoft Direct3D-Laufzeit ruft die GetOverlayColorControls--Funktion auf, um die aktuelle Helligkeit, den Kontrast, den Farbton, die Sättigung, die Schärfe, gamma und die Farbaktivierungseinstellungen zurückzugeben, die einer bestimmten Überlagerung zugeordnet sind.
Die Laufzeit kann auch GetOverlayColorControls- für eine noch nicht sichtbare Überlagerung aufrufen. Wenn in diesem Fall das hOverlay- Mitglied der D3DDDIARG_GETOVERLAYCOLORCONTROLS Struktur, auf das durch pData- verwiesen wird, auf NULL-festgelegt ist, sollte der Treiber die Standardeinstellungen für die Farbsteuerung der Überlagerungshardware zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |