DirectShow DirectShow 레퍼런스 인터페이스 IMediaFilter GetState   [목차열람] [주소복사] [슬롯비우기]
IMediaFilter::GetState
 
Microsoft DirectX 9.0

IMediaFilter::GetState

GetState 메서드는, 필터 상태 (실행, 정지, 포즈)를 얻어온다.

구문

HRESULT GetState(
  DWORD dwMilliSecsTimeout,
  FILTER_STATE *State
);

파라미터

dwMilliSecsTimeout

[in] 타임 아웃 간격 (밀리 세컨드 단위). 무기한으로 동작을 정지하려면 값 INFINITE 를 사용한다.

State

[out] 필터 상태를 나타내는 FILTER_STATE 열거형의 멤버를 받는 변수의 포인터.

반환값

HRESULT 값을 돌려준다. 가능한 값은 다음의 일람대로이다.

값 설명
S_OK 성공.
E_POINTER NULL 포인터 인수.
VFW_S_STATE_INTERMEDIATE 상태 처리중.
VFW_S_CANT_CUE 필터는 액티브하지만, 데이터는 출력할 수 없다.

주의

상태 처리은 비동기에 실시할 수가 있다. 필터가 새로운 상태로 처리하고 있어, 처리이 완료하기 전에 메서드가 타임 아웃이 되면 메서드는 VFW_S_STATE_INTERMEDIATE 를 돌려준다.

필터가 뭔가의 이유로써 데이터를 출력할 수 없는 경우, VFW_S_CANT_CUE 을 돌려준다. 라이브 캡춰 필터는, 포즈 상태에서는 데이터를 출력하지 않기 때문에, 포즈중에 이 값을 돌려준다.

더 자세한 정보는, 「필터 그래프의 데이터 플로우」를 참조할것.

참조

↑TOP