PFND3DDDI_SETOVERLAYCOLORCONTROLS Rückruffunktion (d3dumddi.h)
Die SetOverlayColorControls-Funktion ändert die Farbsteuerungseinstellungen 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 Farbsteuerungseinstellungen wurden erfolgreich geändert. |
| E_INVALIDARG | Die Parameter wurden überprüft und als falsch ermittelt. |
| E_OUTOFMEMORY | SetOverlayColorControls konnte nicht den erforderlichen Arbeitsspeicher zuordnen, um ihn abzuschließen. |
Hinweise
Die Microsoft Direct3D-Runtime ruft die SetOverlayColorControls-Funktion auf, um die Einstellungen für Helligkeit, Kontrast, Farbton, Sättigung, Schärfe, Gamma und Farbaktivierung zu ändern, die einer bestimmten Überlagerung zugeordnet sind.
Die Runtime kann auch SetOverlayColorControls für eine Überlagerung aufrufen, die noch nicht sichtbar ist. Wenn in diesem Fall das hOverlay-Element der D3DDDIARG_SETOVERLAYCOLORCONTROLS Struktur, auf die pData verweist, auf NULL festgelegt ist, sollte der Treiber die angegebenen Farbsteuerungseinstellungen speichern und verwenden, wenn eine Überlagerung erstellt wird, die auf die angegebene Ressource verweist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |