Método CTransformOutputPin.GetMediaType

[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 un tipo de medio preferido, por valor de índice.

Sintaxis

HRESULT GetMediaType(
   int        iPosition,
   CMediaType *pMediaType
);

Parámetros

iPosition

Valor de índice de base cero.

pMediaType

Puntero a un objeto CMediaType que recibe el tipo de medio.

Valor devuelto

Devuelve un valor HRESULT . Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.

Código devuelto	Descripción
S_OK	Correcto
VFW_S_NO_MORE_ITEMS	Índice fuera del intervalo

Observaciones

Este método invalida el método CBasePin::GetMediaType . Si el pin de entrada del filtro no está conectado, el método devuelve VFW_S_NO_MORE_ITEMS. De lo contrario, llama al método CTransformFilter::GetMediaType del filtro para recuperar el tipo de medio. El método CTransformFilter::GetMediaType es virtual puro; La clase derivada del filtro debe invalidarla.

Requisitos

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