Interfaz IEncoderAPI (strmif.h)
[La característica asociada a esta página, Microsoft TV Technologies, es una característica heredada. Microsoft recomienda encarecidamente que el nuevo código no use esta característica.
[IEncoderAPI ya no está disponible para su uso. En su lugar, use ICodecAPI.]
La interfaz IEncoderAPI define una manera estándar de que las aplicaciones y los controladores se comuniquen con codificadores de software o hardware de terceros que implementan la interfaz. Para obtener más información sobre esta interfaz, consulte Api de codificador.
Herencia
La interfaz IEncoderAPI hereda de la interfaz IUnknown . IEncoderAPI también tiene estos tipos de miembros:
- Métodos
Métodos
La interfaz IEncoderAPI tiene estos métodos.
| IEncoderAPI::GetDefaultValue El método GetDefaultValue recupera el valor predeterminado de un parámetro, si existe uno. |
| IEncoderAPI::GetParameterRange El método GetParameterRange recupera el intervalo válido de valores que admite el parámetro, en los casos en los que el parámetro admite un intervalo escalonado en lugar de una lista de valores específicos. |
| IEncoderAPI::GetParameterValues El método GetParameterValues recupera la lista de valores admitidos por el parámetro especificado. |
| IEncoderAPI::GetValue El método GetValue recupera el valor actual de un parámetro especificado. |
| IEncoderAPI::IsAvailable IEncoderAPI ya no está disponible para su uso. (IEncoderAPI.IsAvailable) |
| IEncoderAPI::IsSupported El método IsSupported consulta si se admite un parámetro determinado. |
| IEncoderAPI::SetValue El método SetValue establece el valor actual de un parámetro. |
Comentarios
En los distintos métodos de interfaz, los siguientes GUID, definidos en uuids.h, se usan para indicar qué parámetro se establece o se recupera.
| Parámetro | Descripción |
|---|---|
| ENCAPIPARAM_BITRATE | Especifica la velocidad de bits, en bits por segundo. En el modo de velocidad de bits constante (CBR), el valor proporciona la velocidad de bits constante. En cualquier modo de velocidad de bits variable, proporciona la velocidad de bits promedio. El valor es un long sin signo de 32 bits. |
| ENCAPIPARAM_PEAK_BITRATE | Especifica la velocidad de bits máxima. Este parámetro solo es relevante cuando ENCAPIPARAM_BITRATE_MODE se ha establecido en VariableBitRatePeak. |
| ENCAPIPARAM_BITRATE_MODE | Especifica el modo de velocidad de bits, como un valor de enumeración de VIDEOENCODER_BITRATE_MODE (long de 32 bits con signo). |
En la tabla siguiente se describe el comportamiento esperado de un codificador en condiciones de velocidad de bits extremadamente alta o baja en los dos modos de velocidad de bits variables definidos en VIDEOENCODER_BITRATE_MODE.
| Condición | Mode | Comportamiento |
|---|---|---|
| La escena cae a negro o hay cero movimiento | VariableBitRateAverage | Durante un breve período de tiempo (varios segundos), la velocidad de bits caerá por debajo de la velocidad especificada para el parámetro ENCAPIPARAM_BITRATE. Pero durante un período de cuatro minutos, el codificador mantendrá la velocidad media, si es necesario agregando bits "ficticios" a la secuencia. |
| La escena cae a negro o hay cero movimiento. | VariableBitRatePeak | La velocidad de bits caerá por debajo de la velocidad esperada, tal como se especifica en el valor del parámetro ENCAPIPARAM_BITRATE. La velocidad permanecerá en ese nivel hasta que comience una escena más complicada. |
| La escena es extremadamente compleja. | VariableBitRateAverage | Durante unos segundos, la tasa aumentará. Si la escena permanece compleja, la velocidad volverá a bajar y la imagen se bloqueará para mantener el promedio especificado en el valor del parámetro ENCAPIPARAM_BITRATE. |
| La escena es extremadamente compleja. | VariableBitRatePeak | La tasa aumentará y permanecerá arriba, posiblemente por encima de la tasa esperada, tal como se especifica en el valor del parámetro ENCAPIPARAM_BITRATE, pero nunca por encima del pico, tal como se especifica en el parámetro ENCAPIPARAM_PEAK_BITRATE. |
Dispositivos OCUR
Esta interfaz admite dispositivos OpenCable Unidirectional Cable Receiver (OCUR). Consulte Dispositivos OCUR.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |