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

  • Artigo

Adiciona um efeito a um fluxo de captura.

Sintaxe

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

Parâmetros

[in] dwSourceStreamIndex

O fluxo de captura. O valor pode ser qualquer um dos seguintes.

Valor Significado
0 a 0xFFFFFFFB
 O índice baseado em zero de um fluxo. Para obter o número de fluxos, chame IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 O primeiro fluxo de imagem.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 O primeiro fluxo de vídeo.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 O primeiro fluxo de áudio.

[in] pUnknown

Um ponteiro para um dos seguintes:

  • Uma transformação do Media Foundation (MFT) que expõe a interface IMFTransform .
  • Um objeto de ativação MFT que expõe a interface IMFActivate .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
MF_E_INVALIDMEDIATYPE
 Nenhum tipo de mídia compatível pôde ser encontrado.
MF_E_INVALIDSTREAMNUMBER
 O parâmetro dwSourceStreamIndex é inválido.

Comentários

O efeito deve ser implementado como uma MFT ( Media Foundation Transform ). O parâmetro pUnknown pode apontar para uma instância do MFT ou para um objeto de ativação para o MFT. Para obter mais informações, consulte Objetos de ativação.

O efeito é aplicado ao fluxo antes que os dados atinjam os coletores de captura.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfcaptureengine.h

Confira também

IMFCaptureSource