Что означает код HRESULT 0x80040220 (VFW_E_NO_PALETTE_AVAILABLE)?

 
Предыдущий Следующий
VFW_E_NO_COLOR_KEY_FOUND VFW_E_NO_DISPLAY_PALETTE

VFW_E_NO_PALETTE_AVAILABLE

Практический смысл

VFW_E_NO_PALETTE_AVAILABLE (0X80040220) — результат DirectShow. Исходное описание: AllStat records its meaning as “No palette is available”.. Начните с минимального вызова, который воспроизводит состояние, и сохраните topology до любого rebuild graph.

Конкретные признаки контракта

  • Evidence to collect Capture 1 for this result: media subtype, bit depth and format block.
  • Evidence to collect Capture 2 for this result: palette entry count and source buffer length.
  • Correction and retry boundary Corrective action 3 for this result: select a true-color format when palette presentation is not supported.
  • Likely causes Possible cause 3 for this result: palette data was lost during media-type copying.
  • Correction and retry boundary Corrective action 1 for this result: supply a complete palette for indexed formats.
  • Likely causes Possible cause 2 for this result: the renderer expects an indexed-color palette that the upstream filter did not provide.
  • Difference from nearby HRESULTs VFW_E_NO_DISPLAY_PALETTE means the display itself does not use a palette, while it means required palette data is absent. 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 до и после исправления.

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


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