ホーム › Media.MediaFoundation › MFVideoRenderPrefs

MFVideoRenderPrefs

列挙型

基底型i4

メンバー 10

名前	10進	16進	説明
MFVideoRenderPrefs_DoNotRenderBorder	1	0x1	このフラグが設定されている場合、EVR は境界色を描画しません。既定では、EVR は転送先の四角形のうちビデオがない領域に境界を描画します。IMFVideoDisplayControl::SetBorderColor を参照してください。
MFVideoRenderPrefs_DoNotClipToDevice	2	0x2	このフラグが設定されている場合、ビデオウィンドウが 2 つのモニターにまたがっていても、EVR はビデオをクリップしません。既定では、ビデオウィンドウが 2 つのモニターにまたがっている場合、EVR はビデオの表示領域が最も大きいモニターに合わせてビデオをクリップします。
MFVideoRenderPrefs_AllowOutputThrottling	4	0x4	メモ Windows 7 以降が必要です。 EVR が GPU の帯域幅に合わせて出力を制限することを許可します。
MFVideoRenderPrefs_ForceOutputThrottling	8	0x8	メモ Windows 7 以降が必要です。 EVR に対して、GPU の帯域幅に合わせて出力を制限するよう強制します。
MFVideoRenderPrefs_ForceBatching	16	0x10	メモ Windows 7 以降が必要です。 EVR に対して、Direct3D の Present 呼び出しをバッチ処理するよう強制します。この最適化により、システムがアイドル状態に入る頻度が高くなり、消費電力を削減できます。
MFVideoRenderPrefs_AllowBatching	32	0x20	メモ Windows 7 以降が必要です。 EVR が Direct3D の Present 呼び出しをバッチ処理することを許可します。
MFVideoRenderPrefs_ForceScaling	64	0x40	メモ Windows 7 以降が必要です。 EVR に対して、出力の四角形よりも小さい四角形の内部でビデオを合成するよう強制します。その後、EVR は結果を正しい出力サイズに拡大縮小します。この設定を適用すると、実効解像度は低下します。
MFVideoRenderPrefs_AllowScaling	128	0x80	メモ Windows 7 以降が必要です。 EVR が出力の四角形よりも小さい四角形の内部でビデオを合成することを許可します。
MFVideoRenderPrefs_DoNotRepaintOnStop	256	0x100	メモ Windows 7 以降が必要です。停止コマンドの後に EVR がビデオウィンドウを再描画しないようにします。既定では、EVR は停止コマンドの後にビデオウィンドウを黒で再描画します。
MFVideoRenderPrefs_Mask	511	0x1FF	フラグの値を検証するためのビットマスクです。この値は有効なフラグではありません。

公式ドキュメント

[このページで説明するコンポーネント Enhanced Video Renderer はレガシー機能です。これは MediaPlayer および IMFMediaEngine の各コンポーネントを通じて公開される Simple Video Renderer (SVR) に置き換えられました。ビデオコンテンツを再生するには、これらのコンポーネントのいずれかにデータを送信し、新しいビデオレンダラーをインスタンス化させてください。これらのコンポーネントは Windows 10 および Windows 11 向けに最適化されています。Microsoft は、Windows でビデオメディアを再生する新しいコードでは、可能な限り EVR ではなく MediaPlayer または下位レベルの IMFMediaEngine API を使用することを強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するよう書き換えることを推奨します。]

拡張ビデオレンダラー (EVR) がビデオを表示する方法を定義するフラグを格納します。

解説(Remarks)

これらのフラグを設定するには、IMFVideoDisplayControl::SetRenderingPrefs を呼び出します。

"MFVideoRenderPrefs_Allow..." という名前のフラグは、品質マネージャーから要求された場合にのみ、EVR に低品質の設定を使用させます (詳細については、IMFQualityAdvise を参照してください)。"MFVideoRenderPrefs_Force..." という名前のフラグは、品質マネージャーに関係なく、ビデオミキサーに低品質の設定を使用させます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum MFVideoRenderPrefs : int {
    MFVideoRenderPrefs_DoNotRenderBorder = 1,
    MFVideoRenderPrefs_DoNotClipToDevice = 2,
    MFVideoRenderPrefs_AllowOutputThrottling = 4,
    MFVideoRenderPrefs_ForceOutputThrottling = 8,
    MFVideoRenderPrefs_ForceBatching = 16,
    MFVideoRenderPrefs_AllowBatching = 32,
    MFVideoRenderPrefs_ForceScaling = 64,
    MFVideoRenderPrefs_AllowScaling = 128,
    MFVideoRenderPrefs_DoNotRepaintOnStop = 256,
    MFVideoRenderPrefs_Mask = 511
} MFVideoRenderPrefs;

public enum MFVideoRenderPrefs : int
{
    MFVideoRenderPrefs_DoNotRenderBorder = 1,
    MFVideoRenderPrefs_DoNotClipToDevice = 2,
    MFVideoRenderPrefs_AllowOutputThrottling = 4,
    MFVideoRenderPrefs_ForceOutputThrottling = 8,
    MFVideoRenderPrefs_ForceBatching = 16,
    MFVideoRenderPrefs_AllowBatching = 32,
    MFVideoRenderPrefs_ForceScaling = 64,
    MFVideoRenderPrefs_AllowScaling = 128,
    MFVideoRenderPrefs_DoNotRepaintOnStop = 256,
    MFVideoRenderPrefs_Mask = 511,
}

Public Enum MFVideoRenderPrefs As Integer
    MFVideoRenderPrefs_DoNotRenderBorder = 1
    MFVideoRenderPrefs_DoNotClipToDevice = 2
    MFVideoRenderPrefs_AllowOutputThrottling = 4
    MFVideoRenderPrefs_ForceOutputThrottling = 8
    MFVideoRenderPrefs_ForceBatching = 16
    MFVideoRenderPrefs_AllowBatching = 32
    MFVideoRenderPrefs_ForceScaling = 64
    MFVideoRenderPrefs_AllowScaling = 128
    MFVideoRenderPrefs_DoNotRepaintOnStop = 256
    MFVideoRenderPrefs_Mask = 511
End Enum

import enum

class MFVideoRenderPrefs(enum.IntEnum):
    MFVideoRenderPrefs_DoNotRenderBorder = 1
    MFVideoRenderPrefs_DoNotClipToDevice = 2
    MFVideoRenderPrefs_AllowOutputThrottling = 4
    MFVideoRenderPrefs_ForceOutputThrottling = 8
    MFVideoRenderPrefs_ForceBatching = 16
    MFVideoRenderPrefs_AllowBatching = 32
    MFVideoRenderPrefs_ForceScaling = 64
    MFVideoRenderPrefs_AllowScaling = 128
    MFVideoRenderPrefs_DoNotRepaintOnStop = 256
    MFVideoRenderPrefs_Mask = 511

// MFVideoRenderPrefs
pub const MFVideoRenderPrefs_DoNotRenderBorder: i32 = 1;
pub const MFVideoRenderPrefs_DoNotClipToDevice: i32 = 2;
pub const MFVideoRenderPrefs_AllowOutputThrottling: i32 = 4;
pub const MFVideoRenderPrefs_ForceOutputThrottling: i32 = 8;
pub const MFVideoRenderPrefs_ForceBatching: i32 = 16;
pub const MFVideoRenderPrefs_AllowBatching: i32 = 32;
pub const MFVideoRenderPrefs_ForceScaling: i32 = 64;
pub const MFVideoRenderPrefs_AllowScaling: i32 = 128;
pub const MFVideoRenderPrefs_DoNotRepaintOnStop: i32 = 256;
pub const MFVideoRenderPrefs_Mask: i32 = 511;

// MFVideoRenderPrefs
const (
	MFVideoRenderPrefs_DoNotRenderBorder int32 = 1
	MFVideoRenderPrefs_DoNotClipToDevice int32 = 2
	MFVideoRenderPrefs_AllowOutputThrottling int32 = 4
	MFVideoRenderPrefs_ForceOutputThrottling int32 = 8
	MFVideoRenderPrefs_ForceBatching int32 = 16
	MFVideoRenderPrefs_AllowBatching int32 = 32
	MFVideoRenderPrefs_ForceScaling int32 = 64
	MFVideoRenderPrefs_AllowScaling int32 = 128
	MFVideoRenderPrefs_DoNotRepaintOnStop int32 = 256
	MFVideoRenderPrefs_Mask int32 = 511
)

const
  MFVideoRenderPrefs_DoNotRenderBorder = 1;
  MFVideoRenderPrefs_DoNotClipToDevice = 2;
  MFVideoRenderPrefs_AllowOutputThrottling = 4;
  MFVideoRenderPrefs_ForceOutputThrottling = 8;
  MFVideoRenderPrefs_ForceBatching = 16;
  MFVideoRenderPrefs_AllowBatching = 32;
  MFVideoRenderPrefs_ForceScaling = 64;
  MFVideoRenderPrefs_AllowScaling = 128;
  MFVideoRenderPrefs_DoNotRepaintOnStop = 256;
  MFVideoRenderPrefs_Mask = 511;

// MFVideoRenderPrefs
pub const MFVideoRenderPrefs_DoNotRenderBorder: i32 = 1;
pub const MFVideoRenderPrefs_DoNotClipToDevice: i32 = 2;
pub const MFVideoRenderPrefs_AllowOutputThrottling: i32 = 4;
pub const MFVideoRenderPrefs_ForceOutputThrottling: i32 = 8;
pub const MFVideoRenderPrefs_ForceBatching: i32 = 16;
pub const MFVideoRenderPrefs_AllowBatching: i32 = 32;
pub const MFVideoRenderPrefs_ForceScaling: i32 = 64;
pub const MFVideoRenderPrefs_AllowScaling: i32 = 128;
pub const MFVideoRenderPrefs_DoNotRepaintOnStop: i32 = 256;
pub const MFVideoRenderPrefs_Mask: i32 = 511;

const
  MFVideoRenderPrefs_DoNotRenderBorder* = 1
  MFVideoRenderPrefs_DoNotClipToDevice* = 2
  MFVideoRenderPrefs_AllowOutputThrottling* = 4
  MFVideoRenderPrefs_ForceOutputThrottling* = 8
  MFVideoRenderPrefs_ForceBatching* = 16
  MFVideoRenderPrefs_AllowBatching* = 32
  MFVideoRenderPrefs_ForceScaling* = 64
  MFVideoRenderPrefs_AllowScaling* = 128
  MFVideoRenderPrefs_DoNotRepaintOnStop* = 256
  MFVideoRenderPrefs_Mask* = 511

enum MFVideoRenderPrefs : int {
    MFVideoRenderPrefs_DoNotRenderBorder = 1,
    MFVideoRenderPrefs_DoNotClipToDevice = 2,
    MFVideoRenderPrefs_AllowOutputThrottling = 4,
    MFVideoRenderPrefs_ForceOutputThrottling = 8,
    MFVideoRenderPrefs_ForceBatching = 16,
    MFVideoRenderPrefs_AllowBatching = 32,
    MFVideoRenderPrefs_ForceScaling = 64,
    MFVideoRenderPrefs_AllowScaling = 128,
    MFVideoRenderPrefs_DoNotRepaintOnStop = 256,
    MFVideoRenderPrefs_Mask = 511,
}

#define global MFVideoRenderPrefs_DoNotRenderBorder     0x1
#define global MFVideoRenderPrefs_DoNotClipToDevice     0x2
#define global MFVideoRenderPrefs_AllowOutputThrottling 0x4
#define global MFVideoRenderPrefs_ForceOutputThrottling 0x8
#define global MFVideoRenderPrefs_ForceBatching         0x10
#define global MFVideoRenderPrefs_AllowBatching         0x20
#define global MFVideoRenderPrefs_ForceScaling          0x40
#define global MFVideoRenderPrefs_AllowScaling          0x80
#define global MFVideoRenderPrefs_DoNotRepaintOnStop    0x100
#define global MFVideoRenderPrefs_Mask                  0x1FF