CDynamicOutputPin.StartUsingOutputPin 메서드
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
메서드는 StartUsingOutputPin 스트리밍 작업을 위해 핀에 대한 액세스 권한을 얻습니다.
구문
virtual HRESULT StartUsingOutputPin();
매개 변수
이 메서드에는 매개 변수가 없습니다.
반환 값
HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 표시된 값이 포함됩니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
예기치 않은 오류입니다. |
|
필터가 중지되었거나 핀이 플러시되기 시작했습니다. |
설명
연결된 입력 핀에 데이터를 배달하거나 연결의 미디어 형식을 변경하는 메서드를 호출하기 전에 이 메서드를 호출합니다. 예를 들어 이 규칙은 다음 메서드에 적용됩니다.
- CDynamicOutputPin::ChangeOutputFormat
- CDynamicOutputPin::ChangeMediaType
- CDynamicOutputPin::D ynamicReconnect
- CBaseOutputPin::D eliver
- CBaseOutputPin::D eliverEndOfStream
- CBaseOutputPin::D eliverNewSegment
- IMemInputPin::Receive
- IMemInputPin::ReceiveMultiple
- IPin::EndOfStream
- IPin::NewSegment
그런 다음 CDynamicOutputPin::StopUsingOutputPin 메서드를 호출하여 핀에 대한 액세스를 해제합니다.
핀이 차단되면 StartUsingOutputPin 핀이 차단 해제될 때까지 기다립니다. 메서드가 대기하는 동안 필터가 중지되면 메서드는 즉시 VFW_E_STATE_CHANGED 반환합니다. 핀은 StopUsingOutputPin에 대한 해당 호출 없이 호출된 횟 StartUsingOutputPin 수를 유지 관리합니다. 이 수가 0이 아닌 동안 다른 스레드가 핀을 차단하려고 하면 핀은 차단 상태 "보류 중"으로 설정합니다. StopUsingOutputPin에 대한 최종 호출에서 모든 스트리밍 작업이 완료되면 핀이 차단됩니다.
이 메서드를 호출할 때 CDynamicOutputPin::m_BlockStateLock 중요 섹션을 보관하지 마세요. 그렇지 않으면 핀이 차단되면 차단을 해제할 수 없으므로 교착 상태가 발생합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|