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

IPinFlowControl::Block

Block 메서드는, 핀으로부터의 데이터 플로우의 동작을 정지, 또는 정지 해제한다.

구문

HRESULT Block(
  DWORD dwBlockFlags,
  HANDLE hEvent
);

파라미터

dwBlockFlags

[in] 핀의 동작을 정지할지 어떨지를 나타내는 플래그. 다음의 몇개의 값이 아니면 안된다.

• 제로 :핀으로부터의 데이터 플로우를 정지 해제한다.
• AM_PIN_FLOW_CONTROL_BLOCK :핀으로부터의 데이터 플로우의 동작을 정지한다.

hEvent

[in] 이벤트 개체의 핸들 또는 NULL. 이 인수가 NULL 가 아닌 경우, 메서드는 비동기가 되어, 즉석에서 돌아온다. 조작이 완료 하면, 이벤트가 신호 상태가 된다. 이 인수가 NULL 의 경우, 메서드는 동기가 되어, 핀의 동작이 정지할 때까지 완료하지 않는다. dwBlockFlags 가 제로의 경우, 이 인수는 NULL 이어야 한다.

반환값

HRESULT 값을 돌려준다. 가능한 값은 다음과 같다.

주의

이 메서드는 동기도 비동기도 가능하다.

• 비동기에게 호출하려면 ,CreateEvent 함수를 사용해 이벤트 개체를 생성 한다. 이벤트 핸들을 hEvent 인수에 건네준다. 메서드는 곧바로 돌아와, 조작이 완료 하면 이벤트를 통지한다. WaitForSingleObject 와 같이 기다려 함수를 호출해 그 이벤트를 기다리는 것.
• 동기 해 호출하려면 ,hEvent 인수를 NULL 로 설정한다. 그 메서드는 완료할 때까지 동작을 정지한다. 메서드는 핀이 샘플 출력할 준비를 할 수 있을 때까지 완료하지 않을 가능성이 있다. 필터가 포즈 상태의 경우, 메서드는 무제한하게 동작을 정지할 가능성이 있다. 따라서, 메인의 애플리케이션 thread로부터 이 메서드를 동기 해 호출해서는 안 된다.

참조

• 동적재접속
• 에러 코드와 성공 코드
• IPinFlowControl 인터페이스