Freigeben über


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)

Weitere Informationen

D3DDDIARG_SETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS