Метод IMFCaptureSink::AddStream (mfcaptureengine.h)

  • Статья

Подключает поток из источника записи к этому приемнику захвата.

Синтаксис

HRESULT AddStream(
  [in]  DWORD         dwSourceStreamIndex,
  [in]  IMFMediaType  *pMediaType,
  [in]  IMFAttributes *pAttributes,
  [out] DWORD         *pdwSinkStreamIndex
);

Параметры

[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] pMediaType

Указатель IMFMediaType , указывающий требуемый формат выходного потока. Сведения о формате будут зависеть от приемника записи.

  • Приемник фотографий: формат изображения, совместимый с компонентом обработки изображений Windows (WIC).
  • Приемник предварительного просмотра: несжатый аудио- или видеоформат.
  • Приемник записей: формат звука или видео, который будет записан в выходной файл.

[in] pAttributes

Указатель на интерфейс IMFAttributes . Для сжатых потоков этот параметр можно использовать для настройки кодировщика. Этот параметр также может иметь значение NULL.

Для приемника предварительного просмотра задайте для этого параметра значение NULL.

[out] pdwSinkStreamIndex

Получает индекс нового потока в приемнике записи. Обратите внимание, что этот индекс не обязательно будет соответствовать значению dwSourceStreamIndex.

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

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

Код возврата Описание
S_OK
 Успешно.
MF_E_INVALIDMEDIATYPE
 Формат, указанный в pMediaType , недопустим для этого приемника записи.
MF_E_INVALIDSTREAMNUMBER
 Недопустимый параметр dwSourceStreamIndex или указанный исходный поток уже подключен к этому приемнику.

Требования

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

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

IMFCaptureSink