IAMStreamControl 인터페이스(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
인터페이스는 IAMStreamControl 필터의 개별 스트림을 제어합니다. 일부 필터의 핀은 이 인터페이스를 노출합니다. 예를 들어 AVI Mux 필터 는 입력 핀에서 이 인터페이스를 지원하며 오디오 캡처 필터 및 WDM 비디오 캡처 필터 는 출력 핀에서 지원합니다.
이 인터페이스를 사용하면 애플리케이션이 지정된 시간에 스트림을 켜고 끌 수 있습니다. 예를 들어 애플리케이션은 비디오 미리 보기 중에 오디오를 음소거하기 위해 오디오 스트림을 끌 수 있습니다. 캡처 애플리케이션은 이 인터페이스를 사용하여 정확한 캡처 시작 및 중지 시간을 지정하고 서로 독립적으로 캡처 및 미리 보기 스트림을 제어할 수 있습니다.
이 인터페이스를 사용하려면 IAMStreamControl::StartAt 메서드를 호출하여 핀이 데이터 배달을 시작할 시기를 지정하고 IAMStreamControl::StopAt 메서드를 호출하여 데이터 배달을 중지할 시기를 지정합니다. 그런 다음 필터 그래프 관리자에서 IMediaControl::Run 을 호출하여 필터 그래프를 실행합니다. 모든 시간은 그래프가 실행되기 시작할 때를 기준으로 합니다.
이 인터페이스를 사용하는 경우 다음과 같은 제한 사항에 유의하세요.
- 필터 그래프에 참조 클록이 있어야 합니다.
- 하드웨어 오버레이가 있는 캡처 카드의 미리 보기 핀은 이 인터페이스를 지원하지 않습니다.
- 인터리브된 AVI 파일에 오디오 및 비디오를 캡처하는 경우 AVI Mux 필터에는 두 스트림의 데이터가 모두 필요합니다. 하나의 스트림을 중지하면 필터가 데이터를 인터리브할 수 없습니다. 자세한 내용은 IConfigInterleaving 인터페이스를 참조하세요.
필터 개발자: CBaseStreamControl 기본 클래스는 이 인터페이스를 구현합니다.
상속
IAMStreamControl 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IAMStreamControl 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IAMStreamControl 인터페이스에는 이러한 메서드가 있습니다.
| IAMStreamControl::GetInfo GetInfo 메서드는 시작 및 중지 시간을 포함하여 현재 스트림 제어 설정에 대한 정보를 검색합니다. |
| IAMStreamControl::StartAt StartAt 메서드는 핀에 데이터 배달을 시작할 시기를 알려줍니다. |
| IAMStreamControl::StopAt StopAt 메서드는 핀에 데이터 배달을 중지해야 하는 시기를 알려줍니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |