PFND3DDDI_SETOVERLAYCOLORCONTROLS Rückruffunktion (d3dumddi.h)
Die SetOverlayColorControls--Funktion ändert die Farbsteuerelementeinstellungen für die angegebene Überlagerung.
Syntax
PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;
HRESULT Pfnd3dddiSetoverlaycolorcontrols(
HANDLE hDevice,
const D3DDDIARG_SETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in]
Ein Zeiger auf eine D3DDDIARG_SETOVERLAYCOLORCONTROLS Struktur, die Parameter zum Ändern der Farbsteuerungseinstellungen einer Überlagerung beschreibt.
Rückgabewert
SetOverlayColorControls gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Einstellungen für die Farbsteuerung wurden erfolgreich geändert. |
| E_INVALIDARG | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
| E_OUTOFMEMORY | SetOverlayColorControls konnte den erforderlichen Speicher für den Abschluss nicht zuordnen. |
Bemerkungen
Die Microsoft Direct3D-Laufzeit ruft die SetOverlayColorControls--Funktion auf, um die Helligkeit, den Kontrast, den Farbton, die Sättigung, die Schärfe, das Gamma und die Farbaktivierungseinstellungen zu ändern, die einer bestimmten Überlagerung zugeordnet sind.
Die Laufzeit kann auch SetOverlayColorControls- für eine noch nicht sichtbare Überlagerung aufrufen. Wenn das hOverlay Element der D3DDDIARG_SETOVERLAYCOLORCONTROLS Struktur, auf das von pData- verwiesen wird, auf NULL-festgelegt ist, sollte der Treiber die angegebenen Farbsteuerelementeinstellungen speichern und diese verwenden, wenn eine Überlagerung, die auf die angegebene Ressource verweist, erstellt wird.
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) |