What does HRESULT 0x000D1067 (NS_S_WMG_ADVISE_DROP_TO_KEYFRAME) mean?

NS_S_WMG_ADVISE_DROP_TO_KEYFRAME

Windows Media advises dropping through the next key frame

NS_S_WMG_ADVISE_DROP_TO_KEYFRAME is HRESULT 856167 (0x000D1067) from Windows Media. The documented description is “The timestamp is severely late compared to the current render position; Advise dropping everything up to the next key frame.” The severity bit indicates a nonfailure result, but the value carries a specific condition that must not be collapsed into plain S_OK.

In the legacy Windows Media pipeline or Player state, this result means that the timestamp is severely late compared to the current render position; Advise dropping everything up to the next key frame. Ordinary completion must not be inferred from it until the owning component’s state and outputs agree.

Where the status is encountered

• Windows Media source, reader, writer, or renderer callbacks; log the exact method and object state instead of interpreting the constant outside that contract.
• Windows Media Player SDK automation; log the exact method and object state instead of interpreting the constant outside that contract.
• Media graph, playlist, image, rights, or buffering state; log the exact method and object state instead of interpreting the constant outside that contract.

Evidence to preserve

• Preserve current frame and next key-frame timestamps.
• Preserve codec and GOP structure.
• Preserve skipped frame count.
• Preserve decoder reset state.
• Preserve resulting synchronization offset.

What must be true before accepting it

Verify that the stream can recover decoding state at the next key frame and the skipped interval is acceptable. Only this contract check establishes that it is safe for the caller’s next step.

Correct handling and recovery

Discard dependent frames until the next key frame, reset decoder state as documented, and report the skipped interval. Consider bitrate or resource adaptation afterward.

Before another call following it, confirm that completed side effects are idempotent or reconciled.

Difference from nearby results

A nearby HRESULT can change object ownership, output validity, or the permitted next method.

Practical scenario

A severely late compressed stream cannot catch up by dropping one frame. The graph skips to the next key frame and resumes with a clean decoder reference state.

References

• Microsoft: Windows Media Format SDK error codes — official Microsoft material relevant to this HRESULT.
• Microsoft: Windows Media Player SDK
• Microsoft: Windows Media Player buffering event
• Microsoft: HRESULT values