Что означает код HRESULT 0x8004021B (VFW_E_NOT_OVERLAY_CONNECTION)?

 
Также может означать:
КонстантаТипОС
TPC_E_UNKNOWN_PROPERTYHRESULTWindows
Предыдущий Следующий
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 до и после исправления.

Технические ссылки

Нужно найти другой код? Найти другой код состояния или ошибки.