IAMExtDevice::Calibrate 메서드(strmif.h)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngineMedia 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

추가 정보

오류 및 성공 코드

IAMExtDevice 인터페이스