IWICBitmapCodecInfo::GetColorManagementVersion-Methode (wincodec.h)

Artikel
08/27/2023

Ruft die Vom Codec unterstützte Versionsnummer der Farbverwaltung ab.

Syntax

HRESULT GetColorManagementVersion(
  [in]      UINT  cchColorManagementVersion,
  [in, out] WCHAR *wzColorManagementVersion,
  [in, out] UINT  *pcchActual
);

Parameter

[in] cchColorManagementVersion

Typ: UINT

Die Größe des Versionspuffers. Verwenden Sie 0 beim ersten Aufruf, um die erforderliche Puffergröße zu bestimmen.

[in, out] wzColorManagementVersion

Typ: WCHAR*

Empfängt die Versionsnummer der Farbverwaltung. Verwenden Sie NULL beim ersten Aufruf, um die erforderliche Puffergröße zu bestimmen.

[in, out] pcchActual

Typ: UINT*

Die tatsächliche Puffergröße, die zum Abrufen der vollständigen Versionsnummer der Farbverwaltung erforderlich ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

Das Verwendungsmuster für diese Methode ist ein Zwei-Aufrufprozess. Der erste Aufruf ruft die Puffergröße ab, die zum Abrufen der vollständigen Versionsnummer der Farbverwaltung erforderlich ist, indem sie aufgerufen wird, wobei cchColorManagementVersion auf 0 und wzColorManagementVersion auf NULLfestgelegt ist. Dieser Aufruf legt pcchActual auf die erforderliche Puffergröße fest. Nachdem die erforderliche Puffergröße bestimmt wurde, ruft ein zweiter GetColorManagementVersion-Aufruf mit cchColorManagementVersion auf die Puffergröße und wzColorManagementVersion auf einen Puffer der entsprechenden Größe festgelegt, die Pixelformate ab.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll

Freigeben über