| Previous | Next |
| VFW_E_NOT_OVERLAY_CONNECTION | VFW_E_PALETTE_SET |
VFW_E_NOT_SAMPLE_CONNECTION
Meaning
Windows documents VFW_E_NOT_SAMPLE_CONNECTION as “Current pin connection is not using the IMemInputPin transport”. In practical terms, it is returned when the current DirectShow connection does not use IMemInputPin sample transport required by the requested operation.
Where the failure belongs
This result belongs to DirectShow filter-graph processing. The relevant condition is that the current DirectShow connection does not use IMemInputPin sample transport required by the requested operation.
Likely causes
- Possible cause 1: the graph negotiated an overlay-specific transport.
- Possible cause 2: code requests allocator or sample delivery details from a non-sample connection.
- Possible cause 3: renderer replacement changed transport without refreshing cached interfaces.
Evidence to collect
- Capture 1: connected peer and QueryInterface results for IMemInputPin.
- Capture 2: allocator negotiation history.
- Capture 3: renderer CLSID and graph reconstruction generation.
Diagnostic sequence
- Confirm that the observed path matches this condition: the current DirectShow connection does not use IMemInputPin sample transport required by the requested operation.
Correct handling and retry
- Corrective action 1: branch behavior according to the negotiated transport.
- Corrective action 2: reconnect to a sample-based renderer when the feature requires memory samples.
- Corrective action 3: discard cached transport interfaces after topology changes.
Retry guidance. Retry only after establishing an IMemInputPin connection; repeating allocator calls on an overlay connection cannot help.
Practical scenario
A diagnostic tool requests sample allocator properties from an overlay path; recognizing the transport removes it.
Difference from nearby HRESULTs
VFW_E_NOT_OVERLAY_CONNECTION rejects overlay operations on a sample path; it rejects sample operations on another transport.
Official Microsoft references
Looking for a different code? Search another status or error code.