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 매개 변수에 지정된 최대값보다 높지 않습니다. |
OCUR 디바이스
이 인터페이스는 OpenCable OCUR(단방향 케이블 수신기) 디바이스를 지원합니다. OCUR 디바이스를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |