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)

Confira também

API do codificador