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

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

Категория:

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

Источник:

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

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

Описание:

Установка палитры конфликтует с уже заданным цветовым ключом.%0

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

VFW_E_COLOR_KEY_SET

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

VFW_E_COLOR_KEY_SET (0X8004021E) относится к DirectShow filter graph. Конкретный признак: color key уже установлен. Смысл кода следует проверять на том объекте и generation, где он был возвращён впервые.

Это failure HRESULT; успешность следующего шага подтверждайте отдельным результатом, а не отсутствием исключения в верхнем слое. В первую очередь проверяйте конкретный stage filter graph: pin negotiation, media type, allocator, renderer, source filter или graph lifecycle. Не переносите вывод с соседнего HRESULT только потому, что у него тот же facility или общий компонент.

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

In practical terms, it is returned when DirectShow refuses to install a palette because a color key is already configured for the overlay connection.
The decisive condition is this: DirectShow refuses to install a palette because a color key is already configured for the overlay connection.
AllStat records its meaning as “Setting a palette would conflict with the color key already set”.
Difference from nearby HRESULTs VFW_E_PALETTE_SET blocks a new color key because a palette exists; it blocks a new palette because a key exists.

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

interface/method и CLSID первого компонента, вернувшего HRESULT
graph state, pin names и negotiated media type
allocator/renderer/device state и первый preceding HRESULT

Как проверить границу

Если состояние исчезает после повторной enumeration, отдельно проверьте race между получением объекта и вызовом метода. Для состояния «color key уже установлен» сначала воспроизведите минимальную операцию без параллельных изменений конфигурации, затем сравните before/after evidence.

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

Исправляйте только подтверждённый prerequisite на уровне DirectShow filter graph: входной параметр, capability, object state, provider/graph topology или внешний ресурс. После изменения заново получите актуальные объекты, если их состояние могло устареть, и повторите исходный минимальный вызов.

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

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