What does HRESULT 0x8004021B (VFW_E_NOT_OVERLAY_CONNECTION) mean?

Status / error code:

Category:

Constant name:

Source:

Facility:

Operating System:

Description:

Practical handling of current pin connection is not using the ioverlay transport.

Could be also:
Constant	Type	OS
TPC_E_UNKNOWN_PROPERTY	HRESULT	Windows

Previous	Next
TPC_E_UNKNOWN_PROPERTY	VFW_E_NOT_SAMPLE_CONNECTION

VFW_E_NOT_OVERLAY_CONNECTION

Meaning and numerical form

VFW_E_NOT_OVERLAY_CONNECTION is HRESULT 2147746331 (0x8004021B; signed -2147220965). AllStat records its meaning as “Current pin connection is not using the IOverlay transport”. In practical terms, it is returned when the current DirectShow pin connection does not use the IOverlay transport required by the requested overlay operation.

The severity bit in 0x8004021B is set, so this result is a failure result rather than a success or informational status. Its facility is 4 (FACILITY_ITF) and its low 16-bit code is 539 (0x021B). Those fields classify the value but do not identify the component instance, call, object or input that produced it.

Evidence to collect

A useful diagnostic record for this result includes the native API or interface method, component or CLSID, process and thread IDs, architecture, apartment where relevant, operation correlation ID, elapsed time, input identity, and the first state-changing event before failure. When diagnosing it, preserve IErrorInfo, an inner HRESULT, Win32 status, device event or provider message when available.

Capture 1 for this HRESULT: connected peer and negotiated transport interfaces.
Capture 2 for this HRESULT: pin media type and renderer CLSID.
Capture 3 for this HRESULT: graph-building decision that selected the current renderer.

Telemetry for this HRESULT should retain types, lengths, hashes, stable opaque identifiers and lifecycle generations while redacting content and credentials. This makes repeated incidents comparable without exposing media content, file paths, device identifiers or credentials.

Where the failure belongs

This result belongs to DirectShow filter-graph processing. DirectShow is a legacy, component-based media pipeline. Graph state, pin transport, negotiated media types, allocators, clocks, samples, renderers and source filters contribute separate contracts to the operation. The decisive condition is this: the current DirectShow pin connection does not use the IOverlay transport required by the requested overlay operation. Record the first native producer instead of relying only on a framework exception translated several layers later.

Do not infer from this result alone that reinstalling, rebooting or repeating the whole workflow is appropriate. Because it can cross process and language boundaries, its correction depends on the object identity, lifecycle generation, input and state at the first failing call.

Likely causes

Possible cause 1 for this HRESULT: the graph negotiated memory-sample transport instead of overlay transport.
Possible cause 2 for this HRESULT: a renderer was replaced without updating overlay-specific control code.
Possible cause 3 for this HRESULT: the pin is connected but to a component that does not implement IOverlay.

Diagnostic sequence

Capture it at the first native return and identify the exact object and method.
Confirm that the observed path matches this condition: the current DirectShow pin connection does not use the IOverlay transport required by the requested overlay operation.
compare the live state with the method contract before changing configuration.
collect the code-specific evidence listed above and preserve any more specific preceding error.
change one evidence-backed cause at a time, then repeat the smallest operation that can prove the correction.
Add a regression check that distinguishes it from the related outcomes described below.

Correction and retry boundary

Corrective action 1 for this HRESULT: query the active connection before issuing overlay methods.
Corrective action 2 for this HRESULT: build the graph with an overlay-capable renderer when required.
Corrective action 3 for this HRESULT: use sample-based presentation logic for IMemInputPin connections.

Retry guidance for this HRESULT. Retry only after reconnecting through an overlay transport; the current connection cannot be converted by repeating the same call. A retry must avoid this hazard: replay obsolete samples, duplicate graph changes or reuse interfaces from an earlier topology generation. It must also preserve the evidence needed to locate the original producer of it.

Difference from nearby HRESULTs

VFW_E_NOT_SAMPLE_CONNECTION is the complementary case for code requiring IMemInputPin transport. Keep these outcomes separate in logs, exception mappings, user messages, dashboards and automated retry policy.

Developer and operational guidance

Code handling it should log the failed stage before cleanup, keep ownership and lifecycle transitions explicit, and avoid converting every failure into a generic message. Tests for this HRESULT should cover the primary cause, one adjacent HRESULT and the retry boundary so a future change cannot turn a deterministic contract failure into an uncontrolled loop.

Operational repair for this HRESULT should use supported filter installation, device, graph-building and renderer configuration paths. Avoid unsupported configuration edits or component replacement unless evidence identifies that layer. Retain the original trace and a post-fix trace so the result can be attributed and the change reversed.

Practical scenario

A legacy application assumes its renderer uses overlay after Windows selects a sample-based renderer; detecting the negotiated transport prevents it. The result scenario narrows the result to a reproducible contract boundary and supplies a concrete before-and-after test.

Official Microsoft references

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