PFND3DDDI_GETOVERLAYCOLORCONTROLS Rückruffunktion (d3dumddi.h)
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) |