Referencia de Interfaz IFFMPEGSourceSettings¶

Descripción General¶

La interfaz IFFMPEGSourceSettings proporciona opciones de configuración avanzadas para el filtro DirectShow FFMPEG Source. Esta interfaz permite a los desarrolladores controlar la aceleración por hardware, el comportamiento del buffering, opciones FFmpeg personalizadas y varios callbacks para la reproducción de medios.

Los headers .NET / C++ / Delphi escriben esta interfaz como IFFMPEGSourceSettings (todo en mayúsculas FFMPEG). Las rutas heredadas de archivos IFFmpegSourceSettings.h / .cs mantienen el nombre histórico de archivo en mayúsculas/minúsculas mixtas — pero el símbolo expuesto por los tres lenguajes es la forma toda en mayúsculas. Los dos son identificadores equivalentes en C#; esta página usa la forma toda en mayúsculas de manera consistente con examples.md / index.md.

Definición de Interfaz¶

• Nombre de Interfaz: IFFMPEGSourceSettings
• CLSID del Filtro al que consulta: {1974D893-83E4-4F89-9908-795C524CC17E} (el filtro FFMPEG Source — el IID de la interfaz en sí es distinto; consulte el header).
• Hereda De: IUnknown

Archivos de Definición de Interfaz¶

Las definiciones completas de interfaz están disponibles en GitHub:

• C# (.NET): IFFmpegSourceSettings.cs
• Header C++: IFFmpegSourceSettings.h
• Delphi: VCFiltersAPI.pas (buscar IFFMPEGSourceSettings)

Todas las definiciones de interfaz incluyen:

• Firmas de métodos completas con atributos de marshalling apropiados
• Definiciones de delegados de callback
• Tipos de enumeración (modos de buffering, tipos de medios)
• Documentación de uso y ejemplos

Referencia de Métodos¶

Aceleración por Hardware¶

GetHWAccelerationEnabled¶

Obtiene el estado actual de aceleración por hardware.

Sintaxis (C++):

BOOL GetHWAccelerationEnabled();

Sintaxis (C#):

[PreserveSig]
bool GetHWAccelerationEnabled();

Retorna: TRUE si la aceleración por hardware está habilitada, FALSE en caso contrario.

Predeterminado: TRUE

SetHWAccelerationEnabled¶

Habilita o deshabilita la aceleración de decodificación de video por hardware. Sintaxis (C++):

HRESULT SetHWAccelerationEnabled(BOOL enabled);

[PreserveSig]
int SetHWAccelerationEnabled([MarshalAs(UnmanagedType.Bool)] bool enabled);

IFFmpegSourceSettings* pSettings = nullptr;
pFilter->QueryInterface(IID_IFFmpegSourceSettings, (void**)&pSettings);
// Habilitar aceleración por hardware
pSettings->SetHWAccelerationEnabled(TRUE);
pSettings->Release();

var settings = filter as IFFmpegSourceSettings;
if (settings != null)
{
    // Habilitar aceleración por hardware
    settings.SetHWAccelerationEnabled(true);
}

Configuración de Timeout de Carga¶

GetLoadTimeOut¶

Obtiene el valor actual del timeout de carga de fuente.

Sintaxis (C++):

DWORD GetLoadTimeOut();

Sintaxis (C#):

[PreserveSig]
uint GetLoadTimeOut();

Retorna: Valor de timeout en milisegundos.

Predeterminado: 15000 (15 segundos)

SetLoadTimeOut¶

Establece la duración del timeout para operaciones de carga de fuente. Sintaxis (C++):

HRESULT SetLoadTimeOut(DWORD milliseconds);

[PreserveSig]
int SetLoadTimeOut(uint milliseconds);

// Establecer timeout de 30 segundos para streams de red
pSettings->SetLoadTimeOut(30000);
// Cargar stream RTSP
IFileSourceFilter* pFileSource = nullptr;
pFilter->QueryInterface(IID_IFileSourceFilter, (void**)&pFileSource);
pFileSource->Load(L"rtsp://example.com/stream", nullptr);

Configuración de Buffering¶

GetBufferingMode¶

Obtiene el modo de buffering actual.

Sintaxis (C++):

FFMPEG_SOURCE_BUFFERING_MODE GetBufferingMode();

Sintaxis (C#):

[PreserveSig]
FFMPEG_SOURCE_BUFFERING_MODE GetBufferingMode();

Retorna: Modo de buffering actual (ver enumeración abajo).

Predeterminado: FFMPEG_SOURCE_BUFFERING_MODE_AUTO

SetBufferingMode¶

Establece el modo de buffering para fuentes en vivo. Sintaxis (C++):

HRESULT SetBufferingMode(FFMPEG_SOURCE_BUFFERING_MODE mode);

[PreserveSig]
int SetBufferingMode(FFMPEG_SOURCE_BUFFERING_MODE mode);

// Deshabilitar buffering para stream RTSP de baja latencia
pSettings->SetBufferingMode(FFMPEG_SOURCE_BUFFERING_MODE_OFF);
pSettings->SetLoadTimeOut(5000); // timeout de 5 segundos

// Habilitar buffering para red inestable
settings.SetBufferingMode(FFMPEG_SOURCE_BUFFERING_MODE.ON);

Opciones FFmpeg Personalizadas¶

SetCustomOption¶

Establece una opción FFmpeg personalizada para el demuxer o decodificador.

Sintaxis (C++):

HRESULT SetCustomOption(LPSTR name, LPSTR value);

Sintaxis (C#):

[PreserveSig]
int SetCustomOption([MarshalAs(UnmanagedType.LPStr)] string name,
                     [MarshalAs(UnmanagedType.LPStr)] string value);

Parámetros:

• name: Nombre de la opción (cadena ASCII).
• value: Valor de la opción (cadena ASCII).

Retorna: S_OK (0) en éxito.

Notas de Uso:

• Debe llamarse antes de cargar la fuente
• Permite pasar cualquier opción AVFormatContext o AVCodecContext de FFmpeg
• Las opciones se pasan directamente a las bibliotecas FFmpeg
• Las opciones inválidas se ignoran con una advertencia

Opciones Comunes:

Ejemplo (C++):

// Configurar RTSP para usar transporte TCP
pSettings->SetCustomOption("rtsp_transport", "tcp");

// Establecer timeout de red a 5 segundos
pSettings->SetCustomOption("timeout", "5000000"); // 5 segundos en microsegundos

// Aumentar tamaño de sondeo para mejor detección de formato
pSettings->SetCustomOption("probesize", "10000000"); // 10MB

Ejemplo (C#):

// Configuración de baja latencia
settings.SetCustomOption("fflags", "nobuffer");
settings.SetCustomOption("flags", "low_delay");
settings.SetCustomOption("probesize", "32");

ClearCustomOptions¶

Limpia todas las opciones personalizadas establecidas previamente. Sintaxis (C++):

HRESULT ClearCustomOptions();

[PreserveSig]
int ClearCustomOptions();

pSettings->ClearCustomOptions();

Configuración de Callbacks¶

SetDataCallback¶

Establece una función de callback para recibir datos de video/audio decodificados.

Sintaxis (C++):

HRESULT SetDataCallback(FFMPEGDataCallbackDelegate callback);

Sintaxis (C#):

[PreserveSig]
int SetDataCallback([MarshalAs(UnmanagedType.FunctionPtr)] FFMPEGDataCallbackDelegate callback);

Parámetros:

• callback: Puntero a función de callback.

Retorna: S_OK (0) en éxito.

Firma del Callback (C++):

typedef HRESULT(_stdcall* FFMPEGDataCallbackDelegate) (
    BYTE* buffer,        // Puntero al buffer de datos
    int bufferLen,       // Longitud del buffer en bytes
    int dataType,        // 0 = video, 1 = audio
    LONGLONG startTime,  // Marca de tiempo de inicio (unidades de 100 nanosegundos)
    LONGLONG stopTime    // Marca de tiempo de fin (unidades de 100 nanosegundos)
);

Notas de Uso:

• El callback se invoca para cada frame/muestra de audio decodificado
• Se llama desde el hilo de streaming del filtro - mantener el procesamiento mínimo
• Los datos del buffer son válidos solo durante la ejecución del callback
• Retornar S_OK del callback para continuar el procesamiento

Ejemplo (C++):

HRESULT __stdcall DataCallback(BYTE* buffer, int bufferLen, int dataType,
                                LONGLONG startTime, LONGLONG stopTime)
{
    if (dataType == 0) // Video
    {
        // Procesar frame de video
        ProcessVideoFrame(buffer, bufferLen, startTime);
    }
    else // Audio
    {
        // Procesar datos de audio
        ProcessAudioData(buffer, bufferLen);
    }
    return S_OK;
}

// Establecer callback
pSettings->SetDataCallback(&DataCallback);

SetTimestampCallback¶

Establece una función de callback para recibir información de marcas de tiempo. Sintaxis (C++):

HRESULT SetTimestampCallback(FFMPEGTimestampCallbackDelegate callback);

[PreserveSig]
int SetTimestampCallback([MarshalAs(UnmanagedType.FunctionPtr)] FFMPEGTimestampCallbackDelegate callback);

typedef HRESULT(_stdcall* FFMPEGTimestampCallbackDelegate) (
    int mediaType,              // 0 = video, 1 = audio
    __int64 demuxerStartTime,   // Tiempo de inicio del demuxer
    __int64 streamStartTime,    // Tiempo de inicio del stream
    __int64 timestamp           // Marca de tiempo actual
);

Control de Audio¶

SetAudioEnabled¶

Habilita o deshabilita el procesamiento de stream de audio. Sintaxis (C++):

HRESULT SetAudioEnabled(BOOL enabled);

[PreserveSig]
int SetAudioEnabled([MarshalAs(UnmanagedType.Bool)] bool enabled);

Ejemplo (C++):

// Deshabilitar audio para procesamiento solo de video
pSettings->SetAudioEnabled(FALSE);

Interfaces Relacionadas¶

• IFileSourceFilter - Interfaz DirectShow estándar para cargar archivos/URLs
• IAMStreamSelect - Seleccionar entre múltiples streams de audio/video
• IMediaSeeking - Buscar posiciones específicas en los medios
• IAMStreamConfig - Configurar formato de video/audio

Ver También¶

Documentación¶

• Descripción del Filtro FFMPEG Source - Descripción del producto y características
• Ejemplos de Código - Muestras de código funcionales completas

Definiciones de Interfaz¶

• Interfaz C# (.NET) - Definición completa de interfaz .NET
• Header de Interfaz C++ - Archivo header C++
• Interfaz Delphi - Definición de interfaz Delphi

Muestras Funcionales¶

• Repositorio de Muestras GitHub - Ejemplos funcionales completos para todas las plataformas

Recursos Externos¶

• Documentación FFmpeg - Documentación de bibliotecas FFmpeg
• SDK DirectShow - Documentación Microsoft DirectShow