Compartilhar via

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

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.

Value Meaning
0–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 da Media Foundation (MFT) que expõe a interface IMFTransform .
  • Um objeto de ativação MFT que expõe a interface IMFActivate .

Valor de retorno

Esse método pode retornar um desses valores.

Código de retorno Description
S_OK
 Êxito.
MF_E_INVALIDMEDIATYPE
 Não foi possível encontrar nenhum tipo de mídia compatível.
MF_E_INVALIDSTREAMNUMBER
 O parâmetro dwSourceStreamIndex é inválido.

Observações

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 cheguem aos coletores de captura.

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header mfcaptureengine.h

Consulte também

IMFCaptureSource

  • Last updated on