IAMExtDevice::Calibrate 메서드(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
메서드는 Calibrate 외부 디바이스의 전송 메커니즘을 보정합니다.
이 메서드가 구현되지 않은 경우
구문
HRESULT Calibrate(
[in] HEVENT hEvent,
[in] long Mode,
[out] long *pStatus
);
매개 변수
[in] hEvent
이벤트에 대한 핸들. 작업이 완료되면 이벤트가 신호를 보냅니다.
[in] Mode
보정 프로세스를 활성화하거나 비활성화하는 값을 지정합니다.
| 값 | Description |
|---|---|
| ED_ACTIVE | 보정 프로세스를 활성화합니다. |
| ED_INACTIVE | 보정 프로세스를 비활성화합니다. |
| NULL | 아무 작업도 없습니다. pStatus에서 보정 상태 반환합니다. |
[out] pStatus
다음 값 중 하나를 수신하는 긴 정수에 대한 포인터입니다.
| 값 | Description |
|---|---|
| 오트루 (오트루) | 보정이 활성화되어 있습니다. |
| OAFALSE | 보정이 비활성 상태입니다. |
반환 값
이 메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
설명
보정이 필요한 특정 외부 디바이스에서 이 메서드를 사용합니다. 예를 들어 테이프를 되감고 카운터를 다시 설정하거나 시간 코드 판독기의 프레임 오프셋을 계산합니다.
다양한 외부 디바이스에 대한 필터는 디바이스에 필요한 보정에 따라 이 방법을 다르게 구현할 수 있습니다. 이 메서드는 IMediaEventSink 인터페이스가 이미 이벤트 싱크를 설정했거나 다른 이벤트 신호 메서드가 설정되었다고 가정합니다.
DV 구현
MSDV 및 UVC 드라이버는 이 메서드를 지원하지 않습니다. 메서드는 E_NOTIMPL 반환합니다.요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |
| 라이브러리 | Strmiids.lib |