МЕТОД IMFCaptureSink::P repare (mfcaptureengine.h)

  • Статья

Подготавливает приемник захвата, загружая все необходимые компоненты конвейера, такие как кодировщики, видеопроцессоры и приемники мультимедиа.

Синтаксис

HRESULT Prepare();

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

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

Код возврата Описание
S_OK
 Успешно.
MF_E_INVALIDREQUEST
 Недопустимый запрос.

Комментарии

Вызов этого метода необязателен. Этот метод дает приложению возможность настроить компоненты конвейера перед их использованием. Метод является асинхронным. Если метод возвращает код успешного выполнения, вызывающий объект получит событие MF_CAPTURE_SINK_PREPARED через метод IMFCaptureEngineOnEventCallback::OnEvent . После получения этого события вызовите IMFCaptureSink::GetService , чтобы настроить отдельные компоненты.

Перед вызовом этого метода настройте приемник захвата, добавив по крайней мере один поток. Чтобы добавить поток, вызовите IMFCaptureSink::AddStream.

Метод Prepare завершается ошибкой, если в настоящее время используется приемник записи. Например, вызов метода Подготовки в приемнике предварительного просмотра завершается ошибкой, если обработчик захвата в настоящее время выполняет предварительный просмотр.

Требования

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

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

IMFCaptureSink