_MFP_CREATION_OPTIONS enumeration (mfplay.h)

[The feature associated with this page, MFPlay, is a legacy feature. It has been superseded by MediaPlayer and IMFMediaEngine. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer and IMFMediaEngine instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Specifies options for the MFPCreateMediaPlayer function.

Syntax

typedef enum _MFP_CREATION_OPTIONS {
  MFP_OPTION_NONE = 0,
  MFP_OPTION_FREE_THREADED_CALLBACK = 0x1,
  MFP_OPTION_NO_MMCSS = 0x2,
  MFP_OPTION_NO_REMOTE_DESKTOP_OPTIMIZATION = 0x4
} ;

Constants

MFP_OPTION_NONE Value: 0 Use the default creation options.
MFP_OPTION_FREE_THREADED_CALLBACK Value: 0x1 If set, the MFPlay player object invokes the application's IMFPMediaPlayerCallback callback on another thread, and not the thread that called the MFPCreateMediaPlayer function. Therefore, the callback must be thread safe. If this flag is not set, the player object invokes the callback on the same thread that calls MFPCreateMediaPlayer. This thread must have a message loop. Internally, the player object creates a hidden window to dispatch the callback, similar to the mechanism used for single-threaded apartments (STAs) in COM.
MFP_OPTION_NO_MMCSS Value: 0x2 Do not register the playback topology with the Multimedia Class Scheduler Service (MMCSS). By default, the MFPlay object registers the playback topology with MMCSS, which typically results in a better playback experience. For more information, see IMFWorkQueueServices.
MFP_OPTION_NO_REMOTE_DESKTOP_OPTIMIZATION Value: 0x4 Disables optimizations that are otherwise performed when the application runs in a Remote Desktop Services (RDS, formerly Terminal Services) environment.

Remarks

The following typedef is defined for combining flags from this enumeration.

typedef UINT32 MFP_CREATION_OPTIONS;

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	mfplay.h

See also

Media Foundation Enumerations