Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
[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 para 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.
Inheritance
La interfaz IEncoderAPI hereda de la interfaz IUnknown . IEncoderAPI también tiene estos tipos de miembros:
- Methods
Methods
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 de valores válidos 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. |
Observaciones
En los distintos métodos de interfaz, se usan los siguientes GUID, definidos en uuids.h, 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 media. 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 con signo de 32 bits). |
En la tabla siguiente se describe el comportamiento esperado de un codificador en condiciones de velocidad de bits extremadamente altas o bajas en los dos modos de velocidad de bits variables definidos en VIDEOENCODER_BITRATE_MODE.
| Condición | Modo | 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 se mantendrá al día, 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 especificado en el parámetro ENCAPIPARAM_PEAK_BITRATE. |
Dispositivos OCUR
Esta interfaz admite dispositivos OpenCable Unidirectional Cable Receiver (OCUR). Consulte Dispositivos OCUR.
Requisitos
| Requirement | Value |
|---|---|
| de la plataforma de destino de | Windows |
| Encabezado | strmif.h (include Dshow.h) |