Interface IEncoderAPI (strmif.h)
[O recurso associado a esta página, Microsoft TV Technologies, é um recurso herdado. A 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 API do Codificador.
Herança
A interface IEncoderAPI herda da interface IUnknown . IEncoderAPI também tem esses tipos de membros:
- Métodos
Métodos
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 escalonado 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 há suporte para um determinado parâmetro. |
| IEncoderAPI::SetValue O método SetValue define o valor atual de um parâmetro. |
Comentários
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. Em qualquer 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 | Mode | Comportamento |
|---|---|---|
| Cena cai para preto ou não há movimento | VariableBitRateAverage | Em 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á movimento zero. | 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 aumentará e permanecerá acima, possivelmente 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 (Receptor de Cabo Unidirecional) OpenCable. Consulte Dispositivos OCUR.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |