HRESULT 0x8004021A (VFW_E_NO_COLOR_KEY_SET): значение и диагностика

Код состояния / ошибки:

Категория:

Имя константы:

Источник:

Подсистема (Facility):

Операционная система:

Описание:

Цветовой ключ не задан.%0

Предыдущий	Следующий
VFW_E_CHANGING_FORMAT	TPC_E_UNKNOWN_PROPERTY

VFW_E_NO_COLOR_KEY_SET

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

VFW_E_NO_COLOR_KEY_SET (0X8004021A) относится к DirectShow. Это failure HRESULT. Исходный признак результата зафиксирован в документации как исходное описание результата VFW_E_NO_COLOR_KEY_SET.

Этот результат нужно связывать с первым нативным возвратом и фактическим состоянием объекта; соседний HRESULT того же facility не доказывает ту же причину. Для этой страницы ключевая граница формулируется так: исходное описание результата VFW_E_NO_COLOR_KEY_SET

Специфичные признаки исходного описания

VFW_E_NO_COLOR_KEY_SET is HRESULT 2147746330 ( 0x8004021A ; signed -2147220966). AllStat records its meaning as “No color key has been set”. In practical terms, it is returned when an overlay operation requires a color key but none has been configured for the current surface or connection.
The severity bit in 0x8004021A is set, so this result is a failure result rather than a success or informational status.
Possible cause 1 for this result: the application queries or uses the key before calling the relevant overlay setup.
Possible cause 2 for this result: graph reconstruction discards the previous key.
Possible cause 3 for this result: the renderer selected a mode that does not establish a destination color key.
Graph state, pin transport, negotiated media types, allocators, clocks, samples, renderers and source filters contribute separate contracts to the operation.

Что сохранить до исправления

interface и method, на котором впервые появился HRESULT
CLSID и friendly name задействованных filters, pin names и negotiated media type
graph state/generation, renderer или capture device и первый предшествующий HRESULT
временные метки media sample, rate/clock state и фактические параметры вызова

Как локализовать границу

Проверяйте filter graph, negotiated media type, timing и состояние конкретного interface, а не наличие codec вообще. Сначала воспроизведите минимальный сценарий без параллельного изменения конфигурации; затем сравните сохранённые параметры с условием из исходного описания. Если состояние исчезает после re-enumeration или пересоздания объекта, отдельно проверьте lifetime/generation race.

Исправление и повторная проверка

После исправления повторите тот же минимальный сценарий и убедитесь, что изменился именно подтверждённый prerequisite, а не только порядок событий.

Дополнительные признаки конкретного сценария

Capture 2 for this result: last color-key set call and value.
Capture 1 for this result: overlay connection identity and surface mode.
Capture 3 for this result: display-format changes and graph reconnection events.

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

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