Метод IMFVirtualCamera::Start (mfvirtualcamera.h)
Создает и регистрирует виртуальную камеру.
Синтаксис
HRESULT Start(
IMFAsyncCallback *pCallback
);
Параметры
pCallback
Необязательный указатель на объект IMFAsyncCallback , который конвейер будет использовать для уведомления вызывающей стороны о состоянии виртуальной камеры. Обратный вызов, если он указан, можно вызвать с помощью IMFMediaEvent. При вызове метод IMFMediaEvent::GetType возвращает MEExtendedType или MEError. Если возвращается meExtendedType , метод IMFMediaEvent::GetExtendedType может возвращать один из следующих типов событий:
| Расширенный тип события | Описание |
|---|---|
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE | Пользовательский источник мультимедиа, представляющий виртуальную камеру, инициализирован приложением. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START | Поток (или потоки) в пользовательском источнике мультимедиа виртуальной камеры был запущен приложением. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP | Все потоки в пользовательском источнике мультимедиа виртуальной камеры были остановлены приложением. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE | Пользовательский источник мультимедиа виртуальной камеры не инициализирован. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN | Конвейер виртуальной камеры был выключен. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT | Пользовательское событие было создано пользовательским источником мультимедиа виртуальной камеры. Схема для IMFMediaEvent зависит от поставщика. |
Обратный вызов может быть вызван в любое время после успешного возврата IMFVirtualCamera::Start .
Возвращаемое значение
Возвращает значение HRESULT, включая, помимо прочего, следующие значения:
| Код ошибки | Описание |
|---|---|
| S_OK | Выполнено |
| E_INVALIDARG | Недопустимый входной параметр. |
Комментарии
Пока не будет выполнен успешный вызов метода Start , IMFVirtualCamera представляет сведения о конфигурации виртуальной камеры, а базовая виртуальная камера еще не существует, если MFCreateVirtualCamera повторно не открывает существующую виртуальную камеру. После успешного вызова Startатрибуты IMFAttributes , от которого наследуется IMFVirtualCamera , будут содержать символическое имя ссылки только что созданной виртуальной камеры, MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK.
Если метод MFCreateVirtualCamera вызывается с теми же параметрами, что и при предыдущем вызове, указывая imfVirtualCamera , который уже был запущен с успешным вызовом IMFVirtualCamera::Start, результат IMFVirtualCamera уже находится в допустимом состоянии, а последующие вызовы IMFVirtualCamera::Start могут использоваться для регистрации новых обратных вызовов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Сборка Windows 22000 |
| Верхняя часть | mfvirtualcamera.h |
| Библиотека | mfsensorgroup.lib |
| DLL | mfsensorgroup.dll |