_MFP_CREATION_OPTIONS列挙 (mfplay.h)

  • [アーティクル]
大事な 廃止。 この API は、Windows の今後のリリースから削除される可能性があります。 アプリケーションでは、再生に メディア セッション を使用する必要があります。
 

FPSCreateMediaPlayer 関数のオプションを指定します。

構文

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
} ;

定数

 
MFP_OPTION_NONE
値: 0
既定の作成オプションを使用します。
MFP_OPTION_FREE_THREADED_CALLBACK
値: 0x1
設定した場合、MFPlay プレーヤー オブジェクトは、アプリケーションの IMFPMediaPlayerCallback コールバックを別のスレッドで呼び出します。 これは、MFCreateMediaPlayer 関数を呼び出したスレッドではありません。 したがって、コールバックはスレッド セーフである必要があります。

このフラグが設定されていない場合、プレーヤー オブジェクトは 、MFCCreateMediaPlayer を呼び出すのと同じスレッドでコールバックを呼び出します。 このスレッドにはメッセージ ループが必要です。 内部的には、プレーヤー オブジェクトは、COM のシングル スレッド アパートメント (STA) に使用されるメカニズムと同様に、コールバックをディスパッチする非表示ウィンドウを作成します。
MFP_OPTION_NO_MMCSS
値: 0x2
再生トポロジをマルチメディア クラス スケジューラ サービス (MMCSS) に登録しないでください。 既定では、MFPlay オブジェクトは再生トポロジを MMCSS に登録するため、通常は再生エクスペリエンスが向上します。 詳細については、「 IMFWorkQueueServices」を参照してください。
MFP_OPTION_NO_REMOTE_DESKTOP_OPTIMIZATION
値: 0x4
アプリケーションがリモート デスクトップ サービス (RDS、旧ターミナル サービス) 環境で実行されるときに実行される最適化を無効にします。

解説

この列挙体のフラグを組み合わせるための typedef を次に示します。

typedef UINT32 MFP_CREATION_OPTIONS;

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header mfplay.h

関連項目

Media Foundation 列挙