Функция MFCreateDeviceSourceActivate (mfidl.h)
Создает объект активации, представляющий аппаратное устройство захвата.
Синтаксис
HRESULT MFCreateDeviceSourceActivate(
[in] IMFAttributes *pAttributes,
[out] IMFActivate **ppActivate
);
Параметры
[in] pAttributes
Указатель на интерфейс IMFAttributes хранилища атрибутов, который используется для выбора устройства. См. заметки.
[out] ppActivate
Получает указатель на интерфейс IMFActivate . Вызывающий объект должен освободить интерфейс .
Возвращаемое значение
None
Remarks
Эта функция создает объект активации, который можно использовать для создания источника мультимедиа для аппаратного устройства. Чтобы создать сам источник мультимедиа, вызовите IMFActivate::ActivateObject.
Параметр pAttributes указывает хранилище атрибутов. Чтобы создать хранилище атрибутов, вызовите функцию MFCreateAttributes . Необходимо задать атрибут MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE , который указывает тип устройства (аудио или видео).
Для устройств захвата звука при необходимости задайте один из следующих атрибутов:
| attribute | Описание |
|---|---|
| MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID | Указывает идентификатор конечной точки аудио устройства аудиозахвата. |
| MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE |
Указывает роль устройства. Если этот атрибут задан, функция использует устройство захвата звука по умолчанию для этой роли устройства.
Не сочетайте этот атрибут с атрибутом MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID . |
Если ни тот из атрибутов не указан, функция выбирает устройство аудиозахвата по умолчанию для роли eCommunications .
Для устройств захвата видео необходимо задать следующий атрибут:
| attribute | Описание |
|---|---|
| MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK | Указывает символьную ссылку на устройство. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | mfidl.h |
| Библиотека | Mf.lib |
| DLL | Mf.dll |