Método IMFCaptureSink::AddStream (mfcaptureengine.h)

  • Artículo

Conecta una secuencia desde el origen de captura a este receptor de captura.

Sintaxis

HRESULT AddStream(
  [in]  DWORD         dwSourceStreamIndex,
  [in]  IMFMediaType  *pMediaType,
  [in]  IMFAttributes *pAttributes,
  [out] DWORD         *pdwSinkStreamIndex
);

Parámetros

[in] dwSourceStreamIndex

Secuencia de origen que se va a conectar. El valor puede ser cualquiera de los siguientes.

Valor Significado
0 a 0xFFFFFFFB
 Índice de base cero de una secuencia. Para obtener el número de secuencias, llame a IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 Primera secuencia de imagen.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 Primera secuencia de vídeo.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 Primera secuencia de audio.

[in] pMediaType

Puntero IMFMediaType que especifica el formato deseado del flujo de salida. Los detalles del formato dependerán del receptor de captura.

  • Receptor de fotos: un formato de imagen todavía compatible con windows Imaging Component (WIC).
  • Receptor de vista previa: un formato de audio o vídeo sin comprimir.
  • Receptor de registros: el formato de audio o vídeo que se escribirá en el archivo de salida.

[in] pAttributes

Puntero a la interfaz IMFAttributes . En el caso de las secuencias comprimidas, puede usar este parámetro para configurar el codificador. Este parámetro también puede ser NULL.

Para el receptor de vista previa, establezca este parámetro en NULL.

[out] pdwSinkStreamIndex

Recibe el índice de la nueva secuencia en el receptor de captura. Tenga en cuenta que este índice no coincidirá necesariamente con el valor de dwSourceStreamIndex.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
MF_E_INVALIDMEDIATYPE
 El formato especificado en pMediaType no es válido para este receptor de captura.
MF_E_INVALIDSTREAMNUMBER
 El parámetro dwSourceStreamIndex no es válido o la secuencia de origen especificada ya estaba conectada a este receptor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfcaptureengine.h

Consulte también

IMFCaptureSink