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 인터페이스를 참조하세요.

애플리케이션에 따라 ICaptureGraphBuilder2::ControlStream 메서드가 그래프 수준에서 스트림 컨트롤을 지원하므로 개별 필터 및 핀을 열거할 필요가 없으므로 더 편리할 수 있습니다.

필터 개발자: 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 포함)

추가 정보

CBaseStreamControl 클래스

오류 및 성공 코드