Edit

Share via

IMFCaptureSource::SetCurrentDeviceMediaType method (mfcaptureengine.h)

  • Article

Sets the output format for a capture stream.

Syntax

HRESULT SetCurrentDeviceMediaType(
  [in] DWORD        dwSourceStreamIndex,
  [in] IMFMediaType *pMediaType
);

Parameters

[in] dwSourceStreamIndex

The capture stream to set. The value can be any of the following.

Value Meaning
0–0xFFFFFFFB
 The zero-based index of a stream. To get the number of streams, call IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 The first image stream.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 The first video stream.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 The first audio stream.

[in] pMediaType

A pointer to the IMFMediaType interface.

Return value

This method can return one of these values.

Return code Description
S_OK
 Success.
MF_E_INVALIDSTREAMNUMBER
 The dwSourceStreamIndex parameter is invalid.

Remarks

This method sets the native output type on the capture device. The device must support the specified format. To get the list of available formats, call IMFCaptureSource::GetAvailableDeviceMediaType.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header mfcaptureengine.h

See also

IMFCaptureSource