MFCreateSensorGroup 函数 (mfidl.h)

  • 项目

基于提供的符号链接名称创建 IMFSensorGroup 接口的实例。

语法

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

参数

SensorGroupSymbolicLink

新 IMFSensorGroup 的符号链接。 可以通过设备枚举 API（如 SetupDiGetClassDevs 或 MFEnumDeviceSources）或获取 DeviceInformation 类的 Id 属性来获取此名称。

[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
标头 mfidl.h