| Previous | Next |
| WINCODEC_ERR_UNSUPPORTEDPIXELFORMAT | WINCODEC_ERR_INVALIDREGISTRATION |
WINCODEC_ERR_UNSUPPORTEDOPERATION
WIC components expose optional capabilities
WINCODEC_ERR_UNSUPPORTEDOPERATION means the object is valid but the requested method is outside that component’s implemented feature set. WIC is extensible: decoders, encoders, pixel-format converters, metadata readers, and metadata writers can support different subsets of operations even when they handle the same container format.
The result should lead to capability discovery or a fallback path, not repeated invocation. For example, a decoder can read pixels but not expose a thumbnail, a metadata reader can enumerate data but lack an in-place writer, or a frame can omit progressive-level control. The interface obtained through QueryInterface and the component metadata are stronger evidence than assumptions based only on a file extension.
Capability checks
- Identify the COM interface and method that returned the status.
- Query for the optional interface before depending on format-specific behavior.
- Use component information to distinguish the codec vendor and supported container or pixel formats.
- Provide a documented fallback, such as full decode and re-encode, when in-place work is unsupported.
References
- Microsoft: WIC interfaces
- Microsoft: IWICComponentInfo
- Microsoft: Windows Imaging Component architecture
Looking for a different code? Search another status or error code.