| Previous | Next |
| WINCODEC_ERR_PROPERTYSIZE | WINCODEC_ERR_CODECNOTHUMBNAIL |
WINCODEC_ERR_CODECPRESENT
WINCODEC_ERR_CODECPRESENT identifies a failure in the nonspecific WIC CODECPRESENT status. WIC returned the historical CODECPRESENT status whose official message is nonspecific, so the surrounding codec operation must supply the meaning. Investigation of this result should preserve the original object generation before cleanup, retry, or fallback creates a secondary result.
Where the failure occurs
Microsoft lists CODECPRESENT among WIC codec error values but assigns it a nonspecific message. The name alone is therefore not a reliable success or installation test., the exact component category, CLSID, method, stream, and codec-specific nested diagnostics must define what happened.
Inspect the following boundary: the exact WIC interface method, codec CLSID, and state preceding the status.
Telemetry with explanatory value
| Record | Why it matters here |
|---|---|
| Codec CLSID, vendor, container format, and component category | Preserving codec CLSID, vendor, container format, and component category provides the evidence needed to test this distinction: do not infer success from the word “present”; Microsoft lists it among WIC error codes and gives it the message “An unknown error has occurred.”. |
| Method name and all stream or frame arguments | Recording method name and all stream or frame arguments separates the nonspecific WIC CODECPRESENT status boundary from a later wrapper symptom. |
| COM registration and activation path | In this result diagnostics, recording COM registration and activation path ties the HRESULT to the nonspecific WIC CODECPRESENT status boundary rather than to the final visible failure. |
| Any codec-specific log or inner Win32 result | Comparing any codec-specific log or inner Win32 result shows whether this result follows input, object state, or environment. |
Separate object, input, and environment
| Test | Interpretation | Hold constant |
|---|---|---|
| Same environment, reduced input | If this result disappears with a smaller faithful case, complexity within the nonspecific WIC CODECPRESENT status is implicated. | Keep codec CLSID, vendor, container format, and component category fixed while simplifying COM registration and activation path. |
| Same input, fresh object generation | If it changes after rebuilding state, examine ownership across component discovery, COM activation, stream initialization, codec implementation, and frame operation. | Place method name and all stream or frame arguments on the timeline of the last successful transition. |
| Same operation on a controlled second path | If it follows one environment, the failure is not explained by source data alone. | Compare codec CLSID, process architecture, COM apartment, stream capabilities, and preferred-component policy while preserving any codec-specific log or inner Win32 result. |
Smallest faithful reproducer
When it is returned, enumerate the matching WIC components, record which CLSID is selected, and invoke the same method through a minimal factory client. Compare the inbox codec with third-party preferred components without changing the source bytes.
- Reproduce with the same codec through a minimal IWICImagingFactory client.
- compare a known-good file of the same format.
- When it is returned, enumerate matching components and record which one WIC selects.
- Test with the inbox codec isolated from third-party preferred codecs.
Avoid broad resets
Do not infer success from the word “present”; Microsoft lists it among WIC error codes and gives it the message “An unknown error has occurred.”. Do not write recovery code that treats this HRESULT as evidence that a codec is correctly installed or that image data is valid.
Completion test
A correction for it should let the operation at the nonspecific WIC CODECPRESENT status boundary complete repeatedly under the original supported conditions. Repeat the control that begins with “Reproduce with the same codec through a minimal IWICImagingFactory client” and confirm that the following lifecycle step also succeeds. Keep the original failing sample and one deliberate negative case so fallback cannot be mistaken for repair.
Technical references
When it is returned, these references define the public API family, object model, or error list used to interpret this status.
- Microsoft: Windows Imaging Component codec error codes.
- Microsoft: Windows Imaging Component overview.
- Microsoft: Implementing IWICBitmapDecoder.
- Microsoft: IWICImagingFactory interface.
Looking for a different code? Search another status or error code.