| Предыдущий | Следующий |
| TPC_E_UNKNOWN_PROPERTY | VFW_E_NOT_SAMPLE_CONNECTION |
VFW_E_NOT_OVERLAY_CONNECTION
Практический смысл
VFW_E_NOT_OVERLAY_CONNECTION (0X8004021B) — результат DirectShow. Исходное описание: AllStat records its meaning as “Current pin connection is not using the IOverlay transport”.
. Этот результат локализуйте по interface и состоянию graph непосредственно в момент первого возврата.
Конкретные признаки контракта
- Evidence to collect
Capture 2 for this result: pin media type and renderer CLSID.
- Evidence to collect
Capture 3 for this result: graph-building decision that selected the current renderer.
- Evidence to collect
Capture 1 for this result: connected peer and negotiated transport interfaces.
- Correction and retry boundary
Corrective action 2 for this result: build the graph with an overlay-capable renderer when required.
- 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.
- Likely causes
Possible cause 3 for this result: the pin is connected but to a component that does not implement IOverlay.
- 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.
Что проверить в trace
Сохраните exact method, filter CLSID/friendly name, connected pins, media type, graph state и generation, clock/rate либо sample timestamps, если они участвуют в этой операции. Для persisted data дополнительно фиксируйте offending field или byte range, а для renderer/device path — выбранный hardware capability.
Как отделить этот случай от соседних
Сопоставьте каждый приведённый выше признак с фактическим вызовом. Если условие из исходного контракта не выполняется, не переносите recovery от другого VFW-кода. Если после rebuild или re-enumeration результат исчезает, отдельно проверьте stale object, race и изменение topology.
Исправление и подтверждение
Меняйте только подтверждённую причину: входной параметр, media type, timing, filter connection, renderer/device capability, persisted field или текущее состояние graph. После изменения повторите тот же минимальный сценарий и сравните topology и первый HRESULT до и после исправления.
Технические ссылки
- Microsoft: DirectShow error and success codes.
- Microsoft: IOverlay.
- Microsoft: DirectShow filters and pins.
Нужно найти другой код? Найти другой код состояния или ошибки.