Функция MFCreateSensorGroup (mfidl.h)

Создает экземпляр интерфейса IMFSensorGroup на основе предоставленного имени символьной ссылки.

Синтаксис

HRESULT MFCreateSensorGroup(
        LPCWSTR        SensorGroupSymbolicLink,
  [out] IMFSensorGroup **ppSensorGroup
);

Параметры

SensorGroupSymbolicLink

Символическое звено для новой imfSensorGroup. Это имя можно получить с помощью API перечисления устройств, таких как SetupDiGetClassDevs или MFEnumDeviceSources , или путем получения свойства Id класса DeviceInformation .

[out] ppSensorGroup

Символическое звено для новой imfSensorGroup.

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

Функция возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Предоставленное значение IMFSensorGroup равно NULL.
E_INVALIDARG	Предоставленный LPCWSTR имеет значение NULL.

Комментарии

Если функция выполнена успешно, ppSensorGroup будет указывать на допустимый объект IMFSensorGroup . Вызывающий объект должен освободить этот интерфейс.

Примечание Если этот API используется с символическим именем KSCATEGORY_SENSOR_CAMERA или KSCATEGORY_VIDEO_CAMERA , результирующий объект IMFSensorGroup будет содержать только одно устройство датчика, но ведет себя как виртуализированная группа датчиков. Вызывающий объект может использовать результирующий объект так же, как и группу датчиков, полученную из KSCATEGORY_SENSOR_GROUP.

 

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1607 [классические приложения | Приложения UWP]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	mfidl.h