Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MFCreateSensorGroup function

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

Creates an instance of the IMFSensorGroup interface based on the provided symbolic link name.

Syntax


HRESULT WINAPI MFCreateSensorGroup(
        LPCWSTR        SensorGroupSymbolicLink,
  _Out_ IMFSensorGroup **ppSensorGroup
);

Parameters

SensorGroupSymbolicLink

The symbolic link for the new IMFSensorGroup. This name can be obtained through device enumeration APIs such as This is the symbolic link name obtained through either the standard Win32 device enumeration, such as SetupDiGetClassDevs or MFEnumDeviceSources or by getting the Id property of the DeviceInformation class.

ppSensorGroup [out]

The symbolic link for the new IMFSensorGroup.

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codeDescription
S_OK

The method succeeded.

E_POINTER

The supplied IMFSensorGroup is null.

E_INVALIDARG

The supplied LPCWSTR is null.

 

Remarks

If the function succeeds, ppSesnorGroup will point to a valid IMFSensorGroup object. The caller must release this interface.

Note  When this API is used with a KSCATEGORY_SENSOR_CAMERA or KSCATEGORY_VIDEO_CAMERA symbolic name, the resulting IMFSensorGroup object will only contain one sensor device but behaves as a virtualized sensor group. The caller may use the resulting object in the same manner as a sensor group obtained from a KSCATEGORY_SENSOR_GROUP.
 

Requirements

Minimum supported client

Windows 10, version 1607 [desktop apps only]

Minimum supported server

None supported

Header

Mfidl.h

 

 

Show:
© 2017 Microsoft