MFCreateSensorGroup 函数 (mfidl.h)

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

Syntax

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

参数

SensorGroupSymbolicLink

IMFSensorGroup 的符号链接。 可以通过设备枚举 API(如 SetupDiGetClassDevsMFEnumDeviceSources)或通过获取 DeviceInformation 类的 Id 属性来获取此名称。

[out] ppSensorGroup

IMFSensorGroup 的符号链接。

返回值

该函数返回 HRESULT。 可能的值包括但不限于下表中的值。

返回代码 Description
S_OK
方法成功。
E_POINTER
提供的 IMFSensorGroup 为 null。
E_INVALIDARG
提供的 LPCWSTR 为 null。

注解

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

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

要求

Requirement 价值
最低支持的客户端 Windows 10 版本 1607 [桌面应用 |UWP 应用]
支持的最低服务器 无受支持的版本
目标平台 Windows操作系统
Header mfidl.h
Library mfsensorgroup.lib