Share via


Método IMFCaptureSource::AddEffect (mfcaptureengine.h)

Agrega un efecto a una secuencia de captura.

Sintaxis

HRESULT AddEffect(
  [in] DWORD    dwSourceStreamIndex,
  [in] IUnknown *pUnknown
);

Parámetros

[in] dwSourceStreamIndex

Secuencia de captura. 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] pUnknown

Puntero a uno de los siguientes:

  • Transformación de Media Foundation (MFT) que expone la interfaz IMFTransform .
  • Objeto de activación MFT que expone la interfaz IMFActivate .

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
Correcto.
MF_E_INVALIDMEDIATYPE
No se encontró ningún tipo de medio compatible.
MF_E_INVALIDSTREAMNUMBER
El parámetro dwSourceStreamIndex no es válido.

Comentarios

El efecto debe implementarse como una transformación de Media Foundation (MFT). El parámetro pUnknown puede apuntar a una instancia de MFT o a un objeto de activación para el MFT. Para obtener más información, vea Objetos de activación.

El efecto se aplica a la secuencia antes de que los datos lleguen a los receptores de captura.

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

IMFCaptureSource