_MFP_CREATION_OPTIONS enumeration

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          = 0x00000001,
  MFP_OPTION_NO_MMCSS                        = 0x00000002,
  MFP_OPTION_NO_REMOTE_DESKTOP_OPTIMIZATION  = 0x00000004
} _MFP_CREATION_OPTIONS;

Constants

MFP_OPTION_NONE

Use the default creation options.

MFP_OPTION_FREE_THREADED_CALLBACK

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

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

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

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

 

 

Show: