IEncoderAPI 인터페이스(strmif.h)

[이 페이지와 연결된 기능인 Microsoft TV Technologies는 레거시 기능입니다. 새 코드는 이 기능을 사용하지 않는 것이 좋습니다.]

[IEncoderAPI 는 더 이상 사용할 수 없습니다. 대신 ICodecAPI를 사용합니다.]

IEncoderAPI 인터페이스는 애플리케이션 및 드라이버가 인터페이스를 구현하는 타사 하드웨어 또는 소프트웨어 인코더와 통신하는 표준 방법을 정의합니다. 이 인터페이스에 대한 자세한 내용은 인코더 API를 참조하세요.

상속

IEncoderAPI 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IEncoderAPI 에는 다음과 같은 유형의 멤버도 있습니다.

IEncoderAPI 인터페이스에는 이러한 메서드가 있습니다.


IEncoderAPI::GetDefaultValue GetDefaultValue 메서드는 매개 변수가 있는 경우 매개 변수의 기본값을 검색합니다.
IEncoderAPI::GetParameterRange GetParameterRange 메서드는 매개 변수가 특정 값 목록이 아닌 단계별 범위를 지원하는 경우 매개 변수가 지원하는 유효한 값 범위를 검색합니다.
IEncoderAPI::GetParameterValues GetParameterValues 메서드는 지정된 매개 변수에서 지원하는 값 목록을 검색합니다.
IEncoderAPI::GetValue GetValue 메서드는 지정된 매개 변수의 현재 값을 검색합니다.
IEncoderAPI::IsAvailable IEncoderAPI는 더 이상 사용할 수 없습니다. (IEncoderAPI.IsAvailable)
IEncoderAPI::IsSupported IsSupported 메서드는 지정된 매개 변수가 지원되는지 여부를 쿼리합니다.
IEncoderAPI::SetValue SetValue 메서드는 매개 변수의 현재 값을 설정합니다.

다양한 인터페이스 메서드에서 uuids.h에 정의된 다음 GUID를 사용하여 설정하거나 검색할 매개 변수를 나타냅니다.

매개 변수	Description
ENCAPIPARAM_BITRATE	비트 속도를 초당 비트 단위로 지정합니다. CBR(상수 비트 전송률) 모드에서 값은 상수 비트 전송률을 제공합니다. 두 변수 비트 전송률 모드에서 평균 비트 전송률을 제공합니다. 값은 부호 없는 32비트 길이입니다.
ENCAPIPARAM_PEAK_BITRATE	최대 비트 속도를 지정합니다. 이 매개 변수는 ENCAPIPARAM_BITRATE_MODEVariableBitRatePeak으로 설정된 경우에만 관련이 있습니다.
ENCAPIPARAM_BITRATE_MODE	비트 속도 모드를 VIDEOENCODER_BITRATE_MODE 열거형 값(32비트 부호 있는 길이)으로 지정합니다.

�

다음 표에서는 VIDEOENCODER_BITRATE_MODE 정의된 두 변수 비트 전송률 모드에서 매우 높거나 낮은 비트 전송률 조건에서 인코더의 예상 동작에 대해 설명합니다.

조건	모드	동작
장면이 검은색으로 떨어지거나 모션이 없습니다.	VariableBitRateAverage	짧은 기간(몇 초)에 걸쳐 비트 전송률은 ENCAPIPARAM_BITRATE 매개 변수에 지정된 속도보다 낮아집니다. 그러나 4분 동안 인코더는 스트림에 "더미" 비트를 추가하여 필요한 경우 평균 속도를 유지합니다.
장면이 검은색으로 떨어지거나 동작이 없습니다.	VariableBitRatePeak	비트 전송률은 ENCAPIPARAM_BITRATE 매개 변수 값에 지정된 대로 예상 속도보다 낮습니다. 속도는 더 복잡한 장면이 시작될 때까지 해당 수준으로 유지됩니다.
장면은 매우 복잡합니다.	VariableBitRateAverage	몇 초 동안 속도가 올라갑니다. 장면이 복잡한 상태를 유지하면 속도가 다시 내려가고 그림이 ENCAPIPARAM_BITRATE 매개 변수 값에 지정된 평균을 유지하기 위해 방해가 됩니다.
장면은 매우 복잡합니다.	VariableBitRatePeak	속도는 ENCAPIPARAM_BITRATE 매개 변수 값에 지정된 예상 속도보다 높지만 ENCAPIPARAM_PEAK_BITRATE 매개 변수에 지정된 최대값보다 높지 않습니다.

�

이 인터페이스는 OpenCable OCUR(단방향 케이블 수신기) 디바이스를 지원합니다. OCUR 디바이스를 참조하세요.

요구 사항	값
대상 플랫폼	Windows
헤더	strmif.h(Dshow.h 포함)