Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
[O recurso associado a esta página, Microsoft TV Technologies, é um recurso herdado. Microsoft recomenda fortemente que o novo código não use esse recurso.]
[IEncoderAPI não está mais disponível para uso. Em vez disso, use ICodecAPI.]
A interface IEncoderAPI define uma maneira padrão para aplicativos e drivers se comunicarem com codificadores de hardware ou software de terceiros que implementam a interface. Para obter mais informações sobre essa interface, consulte a API do Codificador.
Inheritance
A interface IEncoderAPI herda da interface IUnknown . IEncoderAPI também tem esses tipos de membros:
- Methods
Methods
A interface IEncoderAPI tem esses métodos.
|
IEncoderAPI::GetDefaultValue O método GetDefaultValue recupera o valor padrão de um parâmetro, se houver um. |
|
IEncoderAPI::GetParameterRange O método GetParameterRange recupera o intervalo válido de valores que o parâmetro dá suporte, nos casos em que o parâmetro dá suporte a um intervalo de etapas em vez de uma lista de valores específicos. |
|
IEncoderAPI::GetParameterValues O método GetParameterValues recupera a lista de valores compatíveis com o parâmetro fornecido. |
|
IEncoderAPI::GetValue O método GetValue recupera o valor atual de um parâmetro especificado. |
|
IEncoderAPI::IsAvailable IEncoderAPI não está mais disponível para uso. (IEncoderAPI.IsAvailable) |
|
IEncoderAPI::IsSupported O método IsSupported consulta se um determinado parâmetro tem suporte. |
|
IEncoderAPI::SetValue O método SetValue define o valor atual de um parâmetro. |
Observações
Nos vários métodos de interface, os seguintes GUIDs, definidos em uuids.h, são usados para indicar qual parâmetro está sendo definido ou recuperado.
| Parâmetro | Descrição |
|---|---|
| ENCAPIPARAM_BITRATE | Especifica a taxa de bits, em bits por segundo. No modo CBR (taxa de bits constante), o valor fornece a taxa de bits constante. No modo de taxa de bits variável, ele fornece a taxa média de bits. O valor é um longo sem sinal de 32 bits. |
| ENCAPIPARAM_PEAK_BITRATE | Especifica a taxa de bits de pico. Esse parâmetro é relevante somente quando ENCAPIPARAM_BITRATE_MODE foi definido como VariableBitRatePeak. |
| ENCAPIPARAM_BITRATE_MODE | Especifica o modo de taxa de bits, como um valor de enumeração VIDEOENCODER_BITRATE_MODE (com sinal de 32 bits). |
A tabela a seguir descreve o comportamento esperado de um codificador em condições de taxa de bits extremamente alta ou baixa nos dois modos de taxa de bits variáveis definidos em VIDEOENCODER_BITRATE_MODE.
| Condição | Modo | Comportamento |
|---|---|---|
| Cena cai para preto ou não há movimento | VariableBitRateAverage | Durante um curto período de tempo (vários segundos), a taxa de bits ficará abaixo da taxa especificada para o parâmetro ENCAPIPARAM_BITRATE. Mas durante um período de quatro minutos, o codificador manterá a taxa média, se necessário, adicionando bits "fictícios" ao fluxo. |
| A cena cai para preto ou não há nenhum movimento. | VariableBitRatePeak | A taxa de bits ficará abaixo da taxa esperada, conforme especificado no valor do parâmetro ENCAPIPARAM_BITRATE. A taxa permanecerá nesse nível até que uma cena mais complicada comece. |
| A cena é extremamente complexa. | VariableBitRateAverage | Por alguns segundos, a taxa aumentará. Se a cena permanecer complexa, a taxa retornará e a imagem ficará bloqueada para manter a média conforme especificado no valor do parâmetro ENCAPIPARAM_BITRATE. |
| A cena é extremamente complexa. | VariableBitRatePeak | A taxa subirá e permanecerá acima da taxa esperada, conforme especificado no valor do parâmetro ENCAPIPARAM_BITRATE, mas nunca acima do pico, conforme especificado no parâmetro ENCAPIPARAM_PEAK_BITRATE. |
Dispositivos OCUR
Essa interface dá suporte a dispositivos OCUR (OpenCable Unidirectional Cable Receiver). Consulte dispositivos OCUR.
Requirements
| Requirement | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |