| 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 WINCODEC_ERR_CODECPRESENT 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 in the WINCODEC_ERR_CODECPRESENT path. For WINCODEC_ERR_CODECPRESENT, the name alone is therefore not a reliable success or installation test. When WINCODEC_ERR_CODECPRESENT is returned, the exact component category, CLSID, method, stream, and codec-specific nested diagnostics must define what happened.
For WINCODEC_ERR_CODECPRESENT, 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 | For WINCODEC_ERR_CODECPRESENT, recording method name and all stream or frame arguments separates the the nonspecific WIC CODECPRESENT status boundary from a later wrapper symptom. |
| COM registration and activation path | In WINCODEC_ERR_CODECPRESENT diagnostics, recording COM registration and activation path ties the HRESULT to the 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 WINCODEC_ERR_CODECPRESENT follows input, object state, or environment. |
Separate object, input, and environment
| Test | Interpretation | Hold constant |
|---|---|---|
| Same environment, reduced input | If WINCODEC_ERR_CODECPRESENT disappears with a smaller faithful case, complexity within the nonspecific WIC CODECPRESENT status is implicated. | For WINCODEC_ERR_CODECPRESENT, keep codec CLSID, vendor, container format, and component category fixed while simplifying COM registration and activation path. |
| Same input, fresh object generation | If WINCODEC_ERR_CODECPRESENT changes after rebuilding state, examine ownership across component discovery, COM activation, stream initialization, codec implementation, and frame operation. | For WINCODEC_ERR_CODECPRESENT, 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 WINCODEC_ERR_CODECPRESENT follows one environment, the failure is not explained by source data alone. | For WINCODEC_ERR_CODECPRESENT, 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 WINCODEC_ERR_CODECPRESENT 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 in the WINCODEC_ERR_CODECPRESENT path.
- Reproduce with the same codec through a minimal IWICImagingFactory client in the WINCODEC_ERR_CODECPRESENT path.
- For WINCODEC_ERR_CODECPRESENT, compare a known-good file of the same format.
- When WINCODEC_ERR_CODECPRESENT is returned, enumerate matching components and record which one WIC selects.
- Test with the inbox codec isolated from third-party preferred codecs in the WINCODEC_ERR_CODECPRESENT path.
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.”. For WINCODEC_ERR_CODECPRESENT, 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 WINCODEC_ERR_CODECPRESENT should let the operation at the 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. For WINCODEC_ERR_CODECPRESENT, keep the original failing sample and one deliberate negative case so fallback cannot be mistaken for repair.
Technical references
When WINCODEC_ERR_CODECPRESENT 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.