Referencia de la Interfaz del Codificador AAC¶

/// <summary>
/// Estructura de configuración del codificador AAC.
/// </summary>
public struct AACConfig
{
    /// <summary>
    /// Versión/perfil AAC (típicamente 2 para AAC-LC, 4 para AAC-HE)
    /// </summary>
    public int version;

    /// <summary>
    /// Tipo de objeto / perfil:
    /// 2 = AAC-LC (Baja Complejidad) - recomendado para la mayoría de usos
    /// 5 = AAC-HE (Alta Eficiencia)
    /// 29 = AAC-HEv2 (Alta Eficiencia versión 2)
    /// </summary>
    public int object_type;

    /// <summary>
    /// Tipo de formato de salida (0 = AAC Raw, 1 = ADTS)
    /// </summary>
    public int output_type;

    /// <summary>
    /// Tasa de bits objetivo en bits por segundo (ej., 128000 para 128 kbps)
    /// </summary>
    public int bitrate;
}

/// <summary>
/// Información en tiempo de ejecución del codificador AAC.
/// </summary>
public struct AACInfo
{
    /// <summary>
    /// Frecuencia de muestreo de entrada en Hz (ej., 44100, 48000)
    /// </summary>
    public int samplerate;

    /// <summary>
    /// Número de canales de audio (1 = mono, 2 = estéreo, 6 = 5.1, etc.)
    /// </summary>
    public int channels;

    /// <summary>
    /// Tamaño del marco AAC en muestras (típicamente 1024 para AAC-LC)
    /// </summary>
    public int frame_size;

    /// <summary>
    /// Número total de marcos codificados
    /// </summary>
    public long frames_done;
}

using System;
using System.Runtime.InteropServices;

namespace VisioForge.DirectShowAPI
{
    /// <summary>
    /// Estructura de configuración del codificador AAC.
    /// </summary>
    [StructLayout(LayoutKind.Sequential)]
    public struct AACConfig
    {
        public int version;
        public int object_type;
        public int output_type;
        public int bitrate;
    }

    /// <summary>
    /// Información en tiempo de ejecución del codificador AAC.
    /// </summary>
    [StructLayout(LayoutKind.Sequential)]
    public struct AACInfo
    {
        public int samplerate;
        public int channels;
        public int frame_size;
        public long frames_done;
    }

    /// <summary>
    /// Interfaz de configuración del codificador Monogram AAC.
    /// Proporciona configuración basada en estructuras para la codificación AAC.
    /// </summary>
    [ComImport]
    [Guid("B2DE30C0-1441-4451-A0CE-A914FD561D7F")]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IMonogramAACEncoder
    {
        /// <summary>
        /// Obtiene la configuración actual del codificador AAC.
        /// </summary>
        /// <param name="config">Referencia a la estructura AACConfig para recibir la configuración actual</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetConfig(ref AACConfig config);

        /// <summary>
        /// Establece la configuración del codificador AAC.
        /// </summary>
        /// <param name="config">Referencia a la estructura AACConfig que contiene la configuración deseada</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetConfig(ref AACConfig config);
    }
}

using System;
using System.Runtime.InteropServices;
namespace VisioForge.DirectShowAPI
{
    /// <summary>
    /// Interfaz de configuración del codificador VisioForge AAC.
    /// Proporciona control completo basado en propiedades sobre los parámetros de codificación AAC.
    /// </summary>
    [ComImport]
    [Guid("0BEF7533-39E6-42a5-863F-E087FAB5D84F")]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IVFAACEncoder
    {
        /// <summary>
        /// Fuerza una frecuencia de muestreo de entrada específica. Establecer en 0 para aceptar cualquier frecuencia.
        /// </summary>
        /// <param name="ulSampleRate">Frecuencia de muestreo en Hz (ej., 44100, 48000). 0 = cualquier frecuencia</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetInputSampleRate(uint ulSampleRate);
        /// <summary>
        /// Obtiene la frecuencia de muestreo de entrada configurada.
        /// </summary>
        /// <param name="pulSampleRate">Recibe la frecuencia de muestreo en Hz. 0 si no está fija</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetInputSampleRate(out uint pulSampleRate);
        /// <summary>
        /// Establece el número de canales de entrada.
        /// </summary>
        /// <param name="nChannels">Número de canales (1=mono, 2=estéreo, 6=5.1, etc.)</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetInputChannels(short nChannels);
        /// <summary>
        /// Obtiene el número de canales de entrada.
        /// </summary>
        /// <param name="pnChannels">Recibe el número de canales</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetInputChannels(out short pnChannels);
        /// <summary>
        /// Establece la tasa de bits objetivo. Establecer en -1 para usar la tasa de bits máxima.
        /// </summary>
        /// <param name="ulBitRate">Tasa de bits en bits por segundo (ej., 128000). -1 = máximo</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetBitRate(uint ulBitRate);
        /// <summary>
        /// Obtiene la tasa de bits configurada.
        /// </summary>
        /// <param name="pulBitRate">Recibe la tasa de bits en bps. -1 si está configurado al máximo</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetBitRate(out uint pulBitRate);
        /// <summary>
        /// Establece el tipo de perfil AAC.
        /// </summary>
        /// <param name="uProfile">Perfil: 2=AAC-LC, 5=AAC-HE, 29=AAC-HEv2</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetProfile(uint uProfile);
        /// <summary>
        /// Obtiene el perfil AAC actual.
        /// </summary>
        /// <param name="puProfile">Recibe el tipo de perfil</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetProfile(out uint puProfile);
        /// <summary>
        /// Establece el formato de salida.
        /// </summary>
        /// <param name="uFormat">Formato: 0=AAC Raw, 1=ADTS</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetOutputFormat(uint uFormat);
        /// <summary>
        /// Obtiene el formato de salida.
        /// </summary>
        /// <param name="puFormat">Recibe el formato de salida</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetOutputFormat(out uint puFormat);
        /// <summary>
        /// Establece el valor de desplazamiento de tiempo para el ajuste de marca de tiempo.
        /// </summary>
        /// <param name="timeShift">Desplazamiento de tiempo en milisegundos</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetTimeShift(int timeShift);
        /// <summary>
        /// Obtiene el valor de desplazamiento de tiempo.
        /// </summary>
        /// <param name="ptimeShift">Recibe el desplazamiento de tiempo en milisegundos</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetTimeShift(out int ptimeShift);
        /// <summary>
        /// Habilita o deshabilita el canal de Efectos de Baja Frecuencia (LFE).
        /// </summary>
        /// <param name="lfe">1 para habilitar LFE, 0 para deshabilitar</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetLFE(uint lfe);
        /// <summary>
        /// Obtiene el estado del canal LFE.
        /// </summary>
        /// <param name="p">Recibe el estado LFE (1=habilitado, 0=deshabilitado)</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetLFE(out uint p);
        /// <summary>
        /// Habilita o deshabilita el Modelado de Ruido Temporal (TNS).
        /// TNS mejora la codificación de sonidos transitorios.
        /// </summary>
        /// <param name="tns">1 para habilitar TNS, 0 para deshabilitar</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetTNS(uint tns);
        /// <summary>
        /// Obtiene el estado de TNS.
        /// </summary>
        /// <param name="p">Recibe el estado TNS (1=habilitado, 0=deshabilitado)</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetTNS(out uint p);
        /// <summary>
        /// Habilita o deshabilita la codificación estéreo Mid-Side.
        /// Puede mejorar la compresión para audio estéreo.
        /// </summary>
        /// <param name="v">1 para habilitar codificación mid-side, 0 para deshabilitar</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int SetMidSide(uint v);
        /// <summary>
        /// Obtiene el estado de codificación mid-side.
        /// </summary>
        /// <param name="p">Recibe el estado mid-side (1=habilitado, 0=deshabilitado)</param>
        /// <returns>HRESULT (0 para éxito)</returns>
        [PreserveSig]
        int GetMidSide(out uint p);
    }
}