Поделиться через

Метод IMFCaptureSource::AddEffect (mfcaptureengine.h)

  • Статья

Добавляет эффект в поток захвата.

Синтаксис

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

Параметры

[in] dwSourceStreamIndex

Поток захвата. Это может быть любое из следующих значений.

Значение Значение
0–0xFFFFFFFB
 Отсчитываемый от нуля индекс потока. Чтобы получить количество потоков, вызовите IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 Первый поток изображения.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 Первый видеопоток.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 Первый аудиопоток.

[in] pUnknown

Указатель на один из следующих объектов:

  • Преобразование Media Foundation (MFT), предоставляющее интерфейс IMFTransform .
  • Объект активации MFT, предоставляющий интерфейс IMFActivate .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
MF_E_INVALIDMEDIATYPE
 Не удалось найти совместимый тип носителя.
MF_E_INVALIDSTREAMNUMBER
 Недопустимый параметр dwSourceStreamIndex .

Комментарии

Эффект должен быть реализован в виде преобразования Media Foundation (MFT). Параметр pUnknown может указывать на экземпляр MFT или на объект активации для MFT. Дополнительные сведения см. в разделе Объекты активации.

Эффект применяется к потоку до того, как данные достигают приемников захвата.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header mfcaptureengine.h

См. также раздел

IMFCaptureSource