Función FreeMediaType

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La función FreeMediaType elimina el bloque de formato en una estructura de AM_MEDIA_TYPE .

Sintaxis

void FreeMediaType(
   AM_MEDIA_TYPE &mt
);

Parámetros

mt [ref]

Referencia a una estructura de AM_MEDIA_TYPE .

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

El bloque de formato se asigna en el montón. El miembro pbFormat del AM_MEDIA_TYPE apunta al bloque de formato. Use esta función para liberar solo el bloque de formato. Para eliminar una estructura de AM_MEDIA_TYPE asignada, llame a DeleteMediaType.

Esta función se define en la biblioteca DirectShow Base Classes . Si prefiere no vincular a la biblioteca de clases base, puede usar el código siguiente:

// Release the format block for a media type.

void _FreeMediaType(AM_MEDIA_TYPE& mt)
{
    if (mt.cbFormat != 0)
    {
        CoTaskMemFree((PVOID)mt.pbFormat);
        mt.cbFormat = 0;
        mt.pbFormat = NULL;
    }
    if (mt.pUnk != NULL)
    {
        // pUnk should not be used.
        mt.pUnk->Release();
        mt.pUnk = NULL;
    }
}

Requisitos

Requisito Value
Encabezado
Mtype.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

DeleteMediaType

Funciones de tipo de medio