MediaFrameReference クラス

リファレンス

定義

名前空間:: Windows.Media.Capture.Frames

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

MediaFrameSource から取得したフレームを表すラッパークラス。このクラスのプロパティを使用して、 VideoMediaFrame や BufferMediaFrame など、ソースによって提供される特定のフレームの種類にアクセスします。

public ref class MediaFrameReference sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaFrameReference final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaFrameReference : System.IDisposable

Public NotInheritable Class MediaFrameReference
Implements IDisposable

継承: Object Platform::Object IInspectable MediaFrameReference

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装: IClosable IDisposable

Windows の要件

デバイスファミリ	Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v3.0 で導入)

注釈

メディアフレームソースから MediaFrameReference のインスタンスを取得するには、目的のメディアフレームソースを使用するように初期化された MediaCapture オブジェクトで CreateFrameReaderAsync を呼び出して MediaFrameReader を作成します。 StartAsync を呼び出してフレームリーダーを起動したら、TryAcquireLatestFrame を呼び出して、メディアフレームソースから最新のフレームを表す MediaFrameReference を取得します。

各 MediaFrameReader は、TryAcquireLatestFrame から取得された MediaFrameReference オブジェクトの循環バッファーを保持します。バッファー内のすべての MediaFrameReference オブジェクトを使用すると、 TryAcquireLatestFrame を呼び出すと、システムは最も古いバッファーオブジェクトで Close (または C# では Dispose ) を呼び出して再利用します。オブジェクトが破棄されると、それを使用してフレームデータにアクセスできなくなります。このため、 MediaFrameReference オブジェクトは、実際にフレームを処理する必要があるよりも長く格納しないでください。アプリのシナリオでデータへの参照を長く保持する必要がある場合は、提供されている API のいずれかを使用して基になるデータを取得する必要があります。次のようなものが含まれます。

これらの API が使用されなくなったときに、これらの API によって返されるオブジェクトに対して Close (または Dispose) を呼び出す必要があります。

重要

MediaFrameReference の VideoMediaFrame プロパティによって提供される SoftwareBitmap オブジェクトまたは Direct3DSurface オブジェクトにアクセスすると、これらのオブジェクトへの厳密な参照が作成されます。つまり、含まれている MediaFrameReference で Dispose を呼び出しても破棄されません。これは、MediaFrameReference.VideoMediaFrame プロパティから取得した VideoFrame オブジェクトによって提供される SoftwareBitmap オブジェクトまたは Direct3DSurface オブジェクトにも適用されます。それらのオブジェクトを即座に破棄するには、SoftwareBitmap または Direct3DSurface の Dispose メソッドを明示的に直接呼び出す必要があります。そうしない場合、最終的にはガーベジコレクターによってこれらのオブジェクトのメモリが解放されますが、それがいつになるかは不明であり、割り当てられたビットマップやサーフェスの数がシステムによって許容される最大数を上回った場合、新しいフレームのフローが停止します。

MediaFrameSource を使用してフレームをキャプチャする方法については、「MediaFrameReader を使用してメディアフレームを処理する」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1803	17134	AudioMediaFrame

プロパティ

AudioMediaFrame	MediaFrameReference によってラップされた AudioMediaFrame を取得します (それが表されるフレームの種類の場合)。
BufferMediaFrame	MediaFrameReference によってラップされた BufferMediaFrame を取得します (それが表されるフレームの種類の場合)。
CoordinateSystem	参照されるメディアフレームの空間座標系が定義されている場合は、その空間座標系を取得します。
Duration	参照されるメディアフレームの期間を取得します。
Format	参照メディアフレームの形式を取得します。
Properties	参照されるフレームのプロパティのマップを取得します。
SourceKind	色、赤外線、カスタムソースなど、参照されるフレームの送信元の MediaFrameSource の種類を取得します。
SystemRelativeTime	システムに対して相対的で、同じデバイス上の複数のメディアソース間で関連付けられるタイムスタンプを取得します。
VideoMediaFrame	MediaFrameReference によってラップされた VideoMediaFrame を取得します (それが表されるフレームの種類の場合)。

メソッド

Close()	オブジェクトと関連付けられているリソースを破棄します。
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

適用対象