| Previous | Next |
| MF_E_BAD_STARTUP_VERSION | MF_E_INVALID_POSITION |
MF_E_UNSUPPORTED_CAPTION
Interpret the result in the pipeline
MF_E_UNSUPPORTED_CAPTION (0xC00D36E4) is a failure result from Windows Media Foundation. The generated section above already contains the platform message; the useful extra information is that this result isolates the URL-related caption string or caption form supplied to the Media Foundation operation is not supported.
The producer is the URL or source helper that validates the caption before opening media, so diagnosis should begin with that object and its state rather than with a broad reinstall or an unrelated codec change. A representative occurrence is a caller appends a display caption in a syntax recognized by another media API but not by the Media Foundation URL helper.
Checkpoint map
| Checkpoint | Question to answer |
|---|---|
| Input | What exact name, type, index, URL, position, media item, account, device, or setup package reached the URL or source helper that validates the caption before opening media? |
| State | Was the object initialized, connected, started, stopped, committed, authorized, or ready when it evaluated the URL-related caption string or caption form supplied to the Media Foundation operation is not supported? |
| Evidence | the original URL, caption text and encoding, API parameters, scheme, and whether the same resource opens without the caption. |
| Completion | Which event, callback, output sample, provider result, or installer action should have followed MF_E_UNSUPPORTED_CAPTION? |
Decisive observations
Collect MF_E_UNSUPPORTED_CAPTION data before automatic retries, Player navigation, device reconnection, source shutdown, or setup rollback destroys it. For MF_E_UNSUPPORTED_CAPTION, the minimum useful record contains the exact returning API, object identity, input identity, current lifecycle state, and the first lower-level failure.
A MF_E_UNSUPPORTED_CAPTION trace must not store credentials, license payloads, private keys, authorization headers, or unrelated library contents. For MF_E_UNSUPPORTED_CAPTION, record identifiers, hashes, lengths, status values, and redacted endpoint information sufficient to correlate the event.
Minimal experiment
- Reproduce once with tracing enabled and preserve
0xC00D36E4before any fallback. - Verify the decisive observation: the original URL, caption text and encoding, API parameters, scheme, and whether the same resource opens without the caption.
- Run the controlled comparison: remove only the caption or replace it with the documented form while preserving the URL and source properties.
- Return to the
MF_E_UNSUPPORTED_CAPTIONbaseline, apply the supported correction, and create a new object generation if the old one entered a terminal state. - Repeat the
MF_E_UNSUPPORTED_CAPTIONtest until the original call advances past this checkpoint and the expected output is validated.
Similar messages, different checkpoints
| HRESULT | Boundary indicated by its standard description |
|---|---|
MF_E_BAD_STARTUP_VERSION | You are calling MFStartup with the wrong MF_VERSION; Mismatched bits; compare this boundary specifically with MF_E_UNSUPPORTED_CAPTION. |
MF_E_INVALID_POSITION | The operation on the current offset is not permitted; compare this boundary specifically with MF_E_UNSUPPORTED_CAPTION. |
MF_E_UNRECOVERABLE_ERROR_OCCURRED | An unrecoverable error has occurred; compare this boundary specifically with MF_E_UNSUPPORTED_CAPTION. |
The codes compared with MF_E_UNSUPPORTED_CAPTION can lead to the same user-facing “cannot play,” “operation failed,” or “setup failed” dialog. They remain technically different. Here, MF_E_INVALIDNAME rejects a general named value; this result is specific to the URL caption accepted by the called helper.
Targeted recovery
For this occurrence, use a supported caption representation or omit the optional caption. For MF_E_UNSUPPORTED_CAPTION, avoid generic cleanup until the original artifact is copied and the producing state is known. A destructive reset during MF_E_UNSUPPORTED_CAPTION diagnosis can remove evidence while leaving the actual policy, device, network, format, or lifecycle error unchanged.
Verification of MF_E_UNSUPPORTED_CAPTION must use the same input and action that failed. Confirm the expected state transition and check that the workflow does not merely substitute another error after MF_E_UNSUPPORTED_CAPTION disappears.
Authoritative references
- Media Foundation architecture — reference used for the
MF_E_UNSUPPORTED_CAPTIONcheckpoint. - Media Foundation error codes — reference used for the
MF_E_UNSUPPORTED_CAPTIONcheckpoint. - Media sources — reference used for the
MF_E_UNSUPPORTED_CAPTIONcheckpoint. - Media Foundation events — reference used for the
MF_E_UNSUPPORTED_CAPTIONcheckpoint.
Looking for a different code? Search another status or error code.