_MFP_CREATION_OPTIONS enumeration (mfplay.h)
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_NONEValue: 0 Use the default creation options. |
MFP_OPTION_FREE_THREADED_CALLBACKValue: 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_MMCSSValue: 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_OPTIMIZATIONValue: 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
| Minimum supported client | Windows 7 [desktop apps only] |
| Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
| Header | mfplay.h |