DirectShow DirectShow 레퍼런스 인터페이스 IGraphConfig RemoveFilterEx   [목차열람] [주소복사] [슬롯비우기]

IGraphConfig::RemoveFilterEx

RemoveFilterEx 메서드는, 필터 그래프로부터 필터를 삭제한다.

구문

HRESULT RemoveFilterEx(
  IBaseFilter *pFilter,
  DWORD Flags
);

파라미터

pFilter

[in] 그래프로부터 삭제하는 필터의 포인터.

Flags

[in] REM_FILTER_FLAGS 열거형의 플래그의 편성.

반환값

성공했을 경우는 S_OK 를 돌려준다. 그 이외의 경우는, 실패의 원인을 나타내는 HRESULT 값을 돌려준다.

주의

이 메서드는,IFilterGraph::RemoveFilter 메서드를 메서드의 동작을 지정하는 플래그를 받아들이도록(듯이) 확장한 것이다. 이 플래그를 사용하면 애플리케이션은 자동적으로 핀으로부터 떼어내는 일 없이 필터를 삭제할 수 있으므로, 접속되고 있는 필터 그룹을 새로운 그래프로 이동할 때 퍼포먼스가 향상한다.

디폴트에서는, 필터는 그래프로부터 삭제되기 전에 절단 된다. 필터를 절단 하지 않기 위해(때문에)는, REMFILTERF_LEAVECONNECTED 플래그를 사용한다.

RemoveFilterEx

참조

• 에러 코드와 성공 코드
• IGraphConfig 인터페이스