IMFSensorGroup::GetSensorDevice method (mfidl.h)

Gets the IMFSensorDevice corresponding to a device in the sensor group.

Syntax

HRESULT GetSensorDevice(
  [in]  DWORD           dwIndex,
  [out] IMFSensorDevice **ppDevice
);

Parameters

[in] dwIndex

The 0-based index of the device to be retrieved. The index must be between 0 and the value returned by GetSensorDeviceCount - 1.

[out] ppDevice

If the call is successful, ppDevice will contain the retrieved sensor device.

Return value

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

Return code Description
S_OK
The method succeeded.
E_POINTER
The ppDevice parameter is null.
MF_E_INVALID_INDEX
the dwIndex parameter is not in the valid range.
MF_E_NOT_INITIALIZED
The sensor group has not been initialized.

Remarks

The term "device" in this context could refer to a physical device, a custom media source, or a frame provider.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1607 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header mfidl.h
Library Mfplat.lib; Mfplat.dll

See also

IMFSensorGroup