Método CMediaSample.GetMediaType

  • 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.

El GetMediaType método recupera el tipo de medio, si el tipo de medio difiere del ejemplo anterior. Este método implementa el método IMediaSample::GetMediaType .

Sintaxis

HRESULT GetMediaType(
   AM_MEDIA_TYPE **ppMediaType
);

Parámetros

ppMediaType

Dirección de una variable que recibe un puntero a una estructura AM_MEDIA_TYPE . Si el tipo de medio no ha cambiado del ejemplo anterior, *ppMediaType se establece en NULL.

Valor devuelto

Devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.

Código devuelto Descripción
S_FALSE
 El tipo de medio no ha cambiado del ejemplo anterior.
S_OK
 Correcto.
E_OUTOFMEMORY
 Memoria insuficiente.

Observaciones

Cuando haya terminado con el tipo de medio, libere el bloque de memoria llamando a la función de utilidad DeleteMediaType .

La variable miembro CMediaSample::m_pMediaType especifica el tipo de medio. La variable miembro CMediaSample::m_dwFlags especifica si el tipo de medio ha cambiado.

Requisitos

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

Consulte también

CMediaSample (clase)