IDirectDrawGammaControl::SetGammaRamp-Methode (ddraw.h)

Artikel
03/01/2024

Legt die roten, grünen und blauen Gammarampen für die primäre Oberfläche fest.

Syntax

HRESULT SetGammaRamp(
  [in] DWORD         unnamedParam1,
  [in] LPDDGAMMARAMP unnamedParam2
);

Parameter

[in] unnamedParam1

Flag, das angibt, ob eine Gammakalibrierung erforderlich ist. Legen Sie diesen Parameter auf DDSGR_CALIBRATE fest, um anzufordern, dass der Kalibrator die Gammarampe entsprechend den physischen Eigenschaften der Anzeige anpasst, wodurch das Ergebnis auf allen Computern identisch ist. Wenn keine Kalibrierung erforderlich ist, legen Sie diesen Parameter auf 0 fest.

[in] unnamedParam2

Ein Zeiger auf eine DDGAMMARAMP-Struktur , die die neuen roten, grünen und blauen Gamma-Rampeneinträge enthält. Jedes Array ordnet Farbwerte im Framepuffer den Farbwerten zu, die an den Digital-Analog-Konverter (DAC) übergeben werden sollen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.

Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:

DDERR_EXCEPTION
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

Hinweise

Nicht alle Systeme unterstützen die Gammakalibrierung. Um zu bestimmen, ob die Gammakalibrierung unterstützt wird, rufen Sie IDirectDraw7::GetCaps auf, und untersuchen Sie das dwCaps2-Element der zugeordnetenDDCAPS-Struktur , nachdem die -Methode zurückgegeben wurde. Wenn das DDCAPS2_CANCALIBRATEGAMMA-Funktionsflag vorhanden ist, wird die Gammakalibrierung unterstützt.

Das Kalibrieren von Gammarampen verursacht einen gewissen Verarbeitungsaufwand und sollte nicht häufig verwendet werden.

Das Einschließen des DDSGR_CALIBRATE-Flags in den dwFlags-Parameter bei der Ausführung auf Computern, die keine Gammakalibrierung unterstützen, führt nicht dazu, dass diese Methode fehlschlägt. Die Methode ist erfolgreich und legt neue Gamma-Rampenwerte ohne Kalibrierung fest.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	ddraw.h
Bibliothek	Ddraw.lib
DLL	Ddraw.dll

Weitere Informationen

IDirectDrawGammaControl

Freigeben über