Share via

CBaseOutputPin.Deliver 메서드

  • 아티클

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 Deliver 미디어 샘플을 연결된 입력 핀에 전달합니다.

구문

virtual HRESULT Deliver(
   IMediaSample *pSample
);

매개 변수

pSample

샘플의 IMediaSample 인터페이스에 대한 포인터입니다.

반환 값

HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 나열된 값이 포함됩니다.

반환 코드 Description
S_OK
 성공.
VFW_E_NOT_CONNECTED
 핀이 연결되어 있지 않습니다.

설명

이 메서드는 입력 핀에서 IMemInputPin::Receive 메서드를 호출합니다. IMemInputPin::ReceiveCanBlock 메서드가 S_OK 반환하는 경우 수신이 차단될 수 있습니다.

이 메서드를 호출한 후 샘플을 해제합니다. 입력 핀은 샘플에 대한 참조 횟수를 보유할 수 있으므로 샘플을 다시 사용하지 마세요. 항상 CBaseOutputPin::GetDeliveryBuffer 메서드를 호출하여 새 샘플을 가져옵니다.

이 메서드를 호출하기 전에 필터의 중요 섹션을 유지합니다. 그렇지 않으면 메서드 호출 중에 핀의 연결이 끊어질 수 있습니다. 필터가 작업자 스레드를 사용하여 샘플을 제공하는 경우 필터가 샘플을 배달할 준비가 되면 중요한 섹션을 보관합니다. 그렇지 않으면 필터의 IMemInputPin::Receive 메서드에서 필터가 샘플을 처리하는 중요한 섹션을 보유할 수 있습니다.

작업자 스레드는 잠재적인 교착 상태를 만들 수 있습니다. 스레드가 중요한 섹션을 보유하는 경우 필터의 상태 변경을 기다릴 수 있습니다. 동시에 상태 변경이 스레드가 완료되기를 기다리고 있을 수 있습니다. 이를 방지하기 위해 상태 변경 코드는 스레드를 종료하는 이벤트에 신호를 준 다음 스레드가 완료 신호를 보낼 때까지 기다려야 합니다.

요구 사항

요구 사항 값
헤더
Amfilter.h(Streams.h 포함)
라이브러리
Strmbase.lib(소매 빌드);
Strmbasd.lib(디버그 빌드)

추가 정보

CBaseOutputPin 클래스