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取得的感測器群組相同的方式來使用產生的物件。