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

IPin::QueryAccept

QueryAccept 메서드는, 지정한 미디어 타입을 핀이 받아들일지 어떨지를 확인한다.

구문

HRESULT QueryAccept(
  const AM_MEDIA_TYPE *pmt
);

파라미터

pmt

[in] 미디어 타입을 지정하는 AM_MEDIA_TYPE 구조체의 포인터.

반환값

다음의 몇개의 값을 돌려준다.

주의

반환값이 S_OK 의 경우, 핀은 다음 샘플로, 또는 핀 접속 후에 미디어 타입을 받아들이는 것을 나타내고 있다. 처리 할 때는, 다른 핀의 접속, 필터로 설정할 수 있는 프로퍼티를 포함한, 필터의 현재 상태를 고려할 필요가 있다.

S_FALSE 를 포함한 그 외의 반환값은, 핀이 그 미디어 타입을 거부하고 있는 것을 나타내고 있다. 따라서, S_OK 는 명시적으로 테스트하는 것. SUCCEEDED 매크로를 사용해서는 안 된다.

필터의 실행중은, 반환값이 S_OK 에서도 확실하지 않다. 핀은, 재접속하지 않고 다음의 미디어 샘플로 포맷의 변경을 받아들이는 경우도 있지만, 재접속할 필요가 있는 경우도 있다. 핀이 IPinConnection 인터페이스를 지원 하는 경우는,IPinConnection::DynamicQueryAccept 메서드를 호출하는 것. 이 메서드는 특히 재접속하지 않고 핀이 새로운 타입을 받아들여질지 어떨지를 테스트한다.

참조

• 필터 그래프의 데이터 플로우
• 동적 포맷 변경
• 에러 코드와 성공 코드
• IPin 인터페이스