Edit

_MFP_CREATION_OPTIONS enumeration (mfplay.h)

  • Article
Important  Deprecated. This API may be removed from future releases of Windows. Applications should use the Media Session for playback.
 

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