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

Статья
08/24/2023

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

Синтаксис

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

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