| Previous | Next |
| TPC_E_NOT_RELEVANT | TPC_E_INVALID_PACKET_DESCRIPTION |
VFW_E_NOT_ALLOWED_TO_SAVE
Meaning
Windows documents VFW_E_NOT_ALLOWED_TO_SAVE as “Updates are not allowed in this state”. In practical terms, it is returned when a DirectShow graph or filter configuration cannot be persisted while it is in the current state.
Where the failure belongs
This result belongs to DirectShow filter-graph processing. The relevant condition is that a DirectShow graph or filter configuration cannot be persisted while it is in the current state.
Likely causes
- Possible cause 1: the graph is running or transitioning.
- Possible cause 2: a component contains active resources that cannot be serialized.
- Possible cause 3: the save operation is attempted during an update or flush.
Evidence to collect
- Capture 1: graph state and transition completion.
- Capture 2: active filters, devices and outstanding samples.
- Capture 3: serialization method and object being persisted.
Diagnostic sequence
- Confirm that the observed path matches this condition: a DirectShow graph or filter configuration cannot be persisted while it is in the current state.
Correct handling and retry
- Corrective action 1: stop and stabilize the graph before saving.
- Corrective action 2: release transient resources not part of the persisted topology.
- Corrective action 3: save only supported graph or component state.
Retry guidance. Retry after the graph reaches the documented savable state and no update is in progress.
Practical scenario
An application saves a graph immediately after issuing Stop without waiting for completion; waiting for the stopped state removes it.
Difference from nearby HRESULTs
VFW_E_WRONG_STATE covers general state mismatch, while it specifically applies to persistence in the current state.
Official Microsoft references
Looking for a different code? Search another status or error code.