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 |
|---|---|
|
성공. |
|
핀이 연결되어 있지 않습니다. |
설명
이 메서드는 입력 핀에서 IMemInputPin::Receive 메서드를 호출합니다. IMemInputPin::ReceiveCanBlock 메서드가 S_OK 반환하는 경우 수신이 차단될 수 있습니다.
이 메서드를 호출한 후 샘플을 해제합니다. 입력 핀은 샘플에 대한 참조 횟수를 보유할 수 있으므로 샘플을 다시 사용하지 마세요. 항상 CBaseOutputPin::GetDeliveryBuffer 메서드를 호출하여 새 샘플을 가져옵니다.
이 메서드를 호출하기 전에 필터의 중요 섹션을 유지합니다. 그렇지 않으면 메서드 호출 중에 핀의 연결이 끊어질 수 있습니다. 필터가 작업자 스레드를 사용하여 샘플을 제공하는 경우 필터가 샘플을 배달할 준비가 되면 중요한 섹션을 보관합니다. 그렇지 않으면 필터의 IMemInputPin::Receive 메서드에서 필터가 샘플을 처리하는 중요한 섹션을 보유할 수 있습니다.
작업자 스레드는 잠재적인 교착 상태를 만들 수 있습니다. 스레드가 중요한 섹션을 보유하는 경우 필터의 상태 변경을 기다릴 수 있습니다. 동시에 상태 변경이 스레드가 완료되기를 기다리고 있을 수 있습니다. 이를 방지하기 위해 상태 변경 코드는 스레드를 종료하는 이벤트에 신호를 준 다음 스레드가 완료 신호를 보낼 때까지 기다려야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|