MFCreateSensorGroup 函数 (mfidl.h)

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

语法

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

SensorGroupSymbolicLink

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

[out] ppSensorGroup

新 IMFSensorGroup 的符号链接。

函数返回 HRESULT。可能的值包括（但并不限于）下表中的项。

如果函数成功， ppSensorGroup 将指向有效的 IMFSensorGroup 对象。调用方必须释放此接口。

注意当此 API 与 KSCATEGORY_SENSOR_CAMERA 或 KSCATEGORY_VIDEO_CAMERA 符号名称一起使用时，生成的 IMFSensorGroup 对象将仅包含一个传感器设备，但充当虚拟化传感器组。调用方可以使用与从 KSCATEGORY_SENSOR_GROUP获取的传感器组相同的方式使用生成的对象。