IWICComponentInfo::GetSpecVersion method (wincodec.h)

2024-02-22

Retrieves the component's specification version.

Syntax

HRESULT GetSpecVersion(
  [in]      UINT  cchSpecVersion,
  [in, out] WCHAR *wzSpecVersion,
  [out]     UINT  *pcchActual
);

Parameters

[in] cchSpecVersion

Type: UINT

The size of the wzSpecVersion buffer.

[in, out] wzSpecVersion

Type: WCHAR*

When this method returns, contain a culture invariant string of the component's specification version. The version form is NN.NN.NN.NN.

[out] pcchActual

Type: UINT*

A pointer that receives the actual length of the component's specification version. The specification version is optional; if a value is not specified by the component, the length returned is 0.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

All built-in components return "1.0.0.0", except for pixel formats, which do not have a spec version.

If cchAuthor is 0 and wzAuthor is NULL, the required buffer size is returned in pccchActual.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	wincodec.h
Library	Windowscodecs.lib
DLL	Windowscodecs.dll