| Previous | Next |
| VFW_E_DVD_RESOLUTION_ERROR | VFW_E_CODECAPI_ENUMERATED |
VFW_E_CODECAPI_LINEAR_RANGE
Meaning
Windows documents VFW_E_CODECAPI_LINEAR_RANGE as “Parameter has linear range”. Here, ICodecAPI reports that a codec property uses a continuous or stepped linear range rather than an enumerated value list.
Relevant contract
This result describes a capability or format boundary in a component graph. Container recognition, elementary-stream parsing, decoder selection, property metadata and renderer acceptance are different stages and need separate evidence.
Start with the source filter, decoder or codec property provider and downstream connection.
Conditions that can produce it
- Cause 1: the caller asks for enumeration semantics on a ranged property.
- Cause 2: UI code assumes every property has discrete choices.
- Cause 3: range metadata was ignored when constructing validation.
Evidence worth preserving
- Evidence 1: property GUID.
- Evidence 2: minimum, maximum, step and default query results.
- Evidence 3: codec CLSID and active media type.
Correction strategy
- Action 1: build numeric controls from the reported range.
- Action 2: clamp and align values to the advertised step.
- Action 3: treat this HRESULT as property-shape information rather than a codec failure.
Retry and recovery
Retry rule: Do not retry the same enumeration request; switch to linear-range handling for this property.
How it differs from nearby results
VFW_E_CODECAPI_ENUMERATED means a property has discrete values and no numeric range, while it means it is described by range metadata.
Example incident
An encoder settings panel requests an enum list for bitrate and receives it; using min, max and step produces the correct numeric control.
Official Microsoft references
Looking for a different code? Search another status or error code.