PFND3DDDI_GETOVERLAYCOLORCONTROLS Rückruffunktion (d3dumddi.h)
Die GetOverlayColorControls-Funktion ruft Farbsteuerungseinstellungen für das angegebene Overlay ab.
Syntax
PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;
HRESULT Pfnd3dddiGetoverlaycolorcontrols(
HANDLE hDevice,
D3DDDIARG_GETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData [ein, aus]
Ein Zeiger auf eine D3DDDIARG_GETOVERLAYCOLORCONTROLS Struktur, die Parameter zum Abrufen der Farbsteuerungseinstellungen eines Overlays beschreibt.
Rückgabewert
GetOverlayColorControls gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Farbsteuerungseinstellungen wurden erfolgreich abgerufen. |
| E_INVALIDARG | Parameter wurden überprüft und als falsch ermittelt. |
| E_OUTOFMEMORY | GetOverlayColorControls konnte den erforderlichen Arbeitsspeicher nicht zuordnen, damit er vollständig ist. |
Hinweise
Die Microsoft Direct3D-Runtime ruft die GetOverlayColorControls-Funktion auf, um die aktuellen Einstellungen für Helligkeit, Kontrast, Farbton, Sättigung, Schärfe, Gamma und Farbaktivierung zurückzugeben, die einer bestimmten Überlagerung zugeordnet sind.
Die Runtime kann auch GetOverlayColorControls für eine Überlagerung aufrufen, die noch nicht sichtbar ist. Wenn in dieser Situation das hOverlay-Element der D3DDDIARG_GETOVERLAYCOLORCONTROLS Struktur, auf die pData verweist, auf NULL festgelegt ist, sollte der Treiber die Standardfarbsteuerungseinstellungen der Overlayhardware zurückgeben.
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) |