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

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

Категория:

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

Источник:

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

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

Описание:

Граф фильтров содержит цикл.%0

Предыдущий	Следующий
VFW_E_ENUM_OUT_OF_RANGE	TPC_E_NOT_RELEVANT

VFW_E_CIRCULAR_GRAPH

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

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

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

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

Confirm that the observed path matches this condition: a DirectShow connection would create a cycle in the filter graph where the graph-building operation requires an acyclic topology.
In practical terms, it is returned when a DirectShow connection would create a cycle in the filter graph where the graph-building operation requires an acyclic topology.
AllStat records its meaning as “The filter graph is circular”.
Possible cause 2 for this result: automatic graph building selects a path through a filter already in the branch.

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

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

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

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

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

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

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

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