IWICBitmapDecoder::QueryCapability method (wincodec.h)

Article
02/22/2024

Retrieves the capabilities of the decoder based on the specified stream.

Syntax

HRESULT QueryCapability(
  [in]  IStream *pIStream,
  [out] DWORD   *pdwCapability
);

Parameters

[in] pIStream

Type: IStream*

The stream to retrieve the decoder capabilities from.

[out] pdwCapability

Type: DWORD*

The WICBitmapDecoderCapabilities of the decoder.

Return value

Type: HRESULT

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

Remarks

Custom decoder implementations should save the current position of the specified IStream, read whatever information is necessary in order to determine which capabilities it can provide for the supplied stream, and restore the stream position.

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

Share via