Saltar a contenido

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.

Definición de Interfaz

  • Nombre de Interfaz: IFFmpegSourceSettings
  • GUID: {1974D893-83E4-4F89-9908-795C524CC17E}
  • Hereda De: IUnknown

Archivos de Definición de Interfaz

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

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);
Sintaxis (C#): 
[PreserveSig]
int SetHWAccelerationEnabled([MarshalAs(UnmanagedType.Bool)] bool enabled);
Parámetros: - enabled: Establezca a TRUE para habilitar aceleración por hardware, FALSE para deshabilitar. Retorna: S_OK (0) en éxito, código de error en caso contrario. Notas de Uso: - Debe llamarse antes de conectar filtros de video downstream - Cuando está habilitado, el filtro intenta usar decodificación por hardware (DXVA, NVDEC, QuickSync, etc.) - Retrocede a decodificación por software si la aceleración por hardware no está disponible - La aceleración por hardware mejora significativamente el rendimiento para códecs H.264, H.265, VP9 y AV1 Ejemplo (C++): 
IFFmpegSourceSettings* pSettings = nullptr;
pFilter->QueryInterface(IID_IFFmpegSourceSettings, (void**)&pSettings);
// Habilitar aceleración por hardware
pSettings->SetHWAccelerationEnabled(TRUE);
pSettings->Release();
Ejemplo (C#): 
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);
Sintaxis (C#): 
[PreserveSig]
int SetLoadTimeOut(uint milliseconds);
Parámetros: - milliseconds: Duración del timeout en milisegundos. Retorna: S_OK (0) en éxito. Notas de Uso: - Debe llamarse antes de cargar el archivo/URL fuente - Particularmente importante para streams de red que pueden tener tiempos de conexión lentos - Establezca valores más altos para conexiones de red lentas o archivos grandes - Establezca valores más bajos para fallar rápidamente en fuentes inalcanzables

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);
Sintaxis (C#): 
[PreserveSig]
int SetBufferingMode(FFMPEG_SOURCE_BUFFERING_MODE mode);
Parámetros: - mode: Modo de buffering a usar. Retorna: S_OK (0) en éxito. Notas de Uso: - Debe llamarse antes de cargar la fuente - Afecta latencia y estabilidad para streams en vivo Modos de Buffering: | Modo | Valor | Descripción | Caso de Uso | |------|-------|-------------|-------------| | FFMPEG_SOURCE_BUFFERING_MODE_AUTO | 0 | Detectar automáticamente si se necesita buffering | Predeterminado - recomendado para la mayoría de escenarios | | FFMPEG_SOURCE_BUFFERING_MODE_ON | 1 | Forzar buffering habilitado | Usar para streams de red inestables | | FFMPEG_SOURCE_BUFFERING_MODE_OFF | 2 | Forzar buffering deshabilitado | Usar para streams en vivo de baja latencia |

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:

Opción Valor Descripción
rtsp_transport tcp o udp Forzar protocolo de transporte RTSP
timeout Microsegundos Timeout de red para protocolos
buffer_size Bytes Tamaño de buffer de entrada
analyzeduration Microsegundos Duración para analizar stream
probesize Bytes Tamaño de datos a sondear
fflags nobuffer Deshabilitar buffering
threads Número Cantidad de hilos del decodificador

ClearCustomOptions

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

HRESULT ClearCustomOptions();
Sintaxis (C#): 
[PreserveSig]
int ClearCustomOptions();
Retorna: S_OK (0) en éxito. Notas de Uso: - Debe llamarse antes de cargar la fuente - Restablece todas las opciones personalizadas a los valores predeterminados de FFmpeg

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

Control de Audio

SetAudioEnabled

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

HRESULT SetAudioEnabled(BOOL enabled);
Sintaxis (C#): 
[PreserveSig]
int SetAudioEnabled([MarshalAs(UnmanagedType.Bool)] bool enabled);
Parámetros: - enabled: Establezca a TRUE para habilitar audio, FALSE para deshabilitar. Retorna: S_OK (0) en éxito. Notas de Uso: - Debe llamarse antes de cargar la fuente - Cuando está deshabilitado, los streams de audio no se decodifican (ahorra CPU/memoria) - Útil para aplicaciones solo video

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

Definiciones de Interfaz

Muestras Funcionales

Recursos Externos