| 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 means the URL-related caption string or caption form supplied to the Media Foundation operation is not supported.
The result comes from the URL or source helper that validates the caption before opening media. A representative case is a caller appends a display caption in a syntax recognized by another media API but not by the Media Foundation URL helper.
Evidence to preserve
the original URL, caption text and encoding, API parameters, scheme, and whether the same resource opens without the caption.
Key observations
Minimal experiment
- Record and verify: 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.
Similar messages, different conditions
| HRESULT | Meaning in the standard description |
|---|---|
MF_E_BAD_STARTUP_VERSION | You are calling MFStartup with the wrong MF_VERSION; Mismatched bits. |
MF_E_INVALID_POSITION | The operation on the current offset is not permitted. |
MF_E_UNRECOVERABLE_ERROR_OCCURRED | An unrecoverable error has occurred. |
Here, MF_E_INVALIDNAME rejects a general named value; it 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.
Authoritative references
Looking for a different code? Search another status or error code.