What does HRESULT 0x00040267 (VFW_S_STREAM_OFF) mean?

 
Previous Next
VFW_S_RESERVED VFW_S_CANT_CUE

VFW_S_STREAM_OFF

DirectShow stream is turned off

VFW_S_STREAM_OFF is HRESULT 262759 (0x00040267) from Video for Windows. The documented description is “The stream has been turned off.” The high-order severity bit is clear, so this is a success result, but it carries more information than plain S_OK.

The operation succeeded while indicating that the relevant stream is disabled and will not currently deliver or render samples.

Where the result is encountered

  • This result can appear in stream-selection interfaces; record the producing interface and method.
  • This result can appear in DVD or multi-stream playback; record the producing interface and method.
  • It can appear in filters that expose optional outputs; record the producing interface and method.

State to verify

The central question is whether the disabled stream is intentional and no required consumer is waiting for its samples.

Evidence to preserve

  • Preserve stream identifier and media type.
  • Preserve selection flags.
  • Preserve upstream and downstream pin state.
  • Preserve user language or track choice.
  • Preserve timestamp of the enable/disable transition.

Correct handling, retry, and recovery

Keep the stream disabled when requested, and update UI and graph expectations accordingly. Re-enable through the owning stream-selection contract rather than reconnecting arbitrary pins.

Diagnostic sequence

  • Capture the raw HRESULT 0x00040267 immediately after the returning method and record whether the caller used SUCCEEDED, FAILED, equality testing, or exception translation.
  • Verify the method-specific state: the disabled stream is intentional and no required consumer is waiting for its samples.

Practical validation scenario

A player switches from commentary audio to the main track. The commentary stream reports it, its UI indicator changes, and no timeout monitor expects samples from that pin.

Difference from nearby HRESULT values

VFW_S_RESOURCE_NOT_NEEDED describes an unused resource; it describes the delivery state of a stream.

Developer and administrator guidance

References

Looking for a different code? Search another status or error code.