IWICDevelopRaw::SetNamedWhitePoint-Methode (wincodec.h)

Legt den benannten Weißpunkt der Rohdatei fest.

Syntax

HRESULT SetNamedWhitePoint(
  [in] WICNamedWhitePoint WhitePoint
);

Parameter

[in] WhitePoint

Typ: WICNamedWhitePoint

Eine bitweise Kombination der Enumerationswerte.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn die benannten Weißen Punkte vom Rohbild nicht unterstützt werden oder die Rohdatei benannte Weiße Punkte enthält, die von dieser API nicht unterstützt werden, sollte die Codecimplementierung diese Funktion trotzdem als unterstützt markieren.

Wenn die benannten Weißen Punkte vom Rohbild nicht unterstützt werden, sollten Sie sich bemühen, das Bild an den benannten Weißpunkt anzupassen, auch wenn es sich nicht um einen vordefinierten Weißpunkt der Rohdatei handelt.

Wenn die Rohdatei benannte Weiße Punkte enthält, die von dieser API nicht unterstützt werden, sollte der Codecimplementierungs-Implementierungser die benannten Weißen Punkte in der API unterstützen.

Aufgrund anderer Weißpunkteinstellungsmethoden (z. B. SetWhitePointKelvin) muss die Codecimplementierung darauf achten, dass eine ordnungsgemäße Interoperabilität gewährleistet ist. Wenn der Aufrufer für instance über einen benannten Weißpunkt festlegt, möchte der Codec-Implementierer möglicherweise das Zurücklesen der entsprechenden Kelvintemperatur deaktivieren. In bestimmten Fällen, in denen der Codecimplementierer eine bestimmte Aktion aufgrund früherer Aufrufe verweigern möchte, sollte WINCODEC_ERR_WRONGSTATE zurückgegeben werden.

Anforderungen