Compartir a través de


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

Agrega un efecto a una secuencia de captura.

Syntax

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

Parámetros

[in] dwSourceStreamIndex

Secuencia de captura. El valor puede ser cualquiera de los siguientes.

Importancia Meaning
0-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 imágenes.
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:

  • Una 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 de retorno Description
S_OK
Éxito.
MF_E_INVALIDMEDIATYPE
No se encontró ningún tipo de medio compatible.
MF_E_INVALIDSTREAMNUMBER
El parámetro dwSourceStreamIndex no es válido.

Observaciones

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 al flujo antes de que los datos lleguen a los receptores de captura.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2012 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header mfcaptureengine.h

Consulte también

IMFCaptureSource