Método IMFPMediaItem::SetStreamSink (mfplay.h)

  • Artículo
Importante Obsoleto. Esta API se puede quitar de futuras versiones de Windows. Las aplicaciones deben usar la sesión multimedia para la reproducción.
 

Establece un receptor de medios para el elemento multimedia. Un receptor de medios es un objeto que consume los datos de una o varias secuencias.

Sintaxis

HRESULT SetStreamSink(
  [in] DWORD    dwStreamIndex,
  [in] IUnknown *pMediaSink
);

Parámetros

[in] dwStreamIndex

Índice de base cero de una secuencia en el origen multimedia. El receptor de medios recibirá los datos de esta secuencia.

[in] pMediaSink

Puntero IUnknown que especifica el receptor de medios. Pase uno de los siguientes pasos:

  • Puntero a un receptor de flujo. Cada receptor de medios contiene uno o varios receptores de secuencias. Cada receptor de flujo recibe los datos de una secuencia. El receptor de la secuencia debe exponer la interfaz IMFStreamSink .
  • Puntero a un objeto de activación que crea el receptor multimedia. El objeto de activación debe exponer la interfaz IMFActivate . El elemento multimedia usa el primer receptor de secuencia en el receptor de medios (es decir, el receptor de la secuencia en el índice 0).
  • NULL. Si establece pMediaSink en NULL, se usa el receptor de medios predeterminado para el tipo de secuencia.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

De forma predeterminada, el objeto del reproductor MFPlay representa las secuencias de audio en el representador de audio de streaming (SAR) y las secuencias de vídeo en el representador de vídeo mejorado (EVR). Puede usar el método SetStreamSink para proporcionar un receptor multimedia diferente para una secuencia de audio o vídeo; o para admitir otros tipos de secuencias además de audio y vídeo. También puede usarlo para configurar el SAR o EVR antes de que se usen.

Llame a este método antes de llamar a IMFPMediaPlayer::SetMediaItem. Llamar a este método después de SetMediaItem no tiene ningún efecto, a menos que detenga la reproducción y llame a SetMediaItem de nuevo.

Para restablecer el elemento multimedia para usar el receptor de medios predeterminado, establezca pMediaSink en NULL.

Optimizaciones de reproducción remota

Si la aplicación se ejecuta a través de Escritorio remoto y llama a este método con un valor distinto de NULL para una secuencia de audio o vídeo, MFPlay deshabilita las optimizaciones de reproducción remota. Este comentario solo se aplica a secuencias de audio y vídeo. No se aplica a las secuencias que contienen algún otro tipo de datos, como el texto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfplay.h

Consulte también

IMFPMediaItem

Receptores de medios

Uso de MFPlay para la reproducción de audio y vídeo