MediaFrameReference クラス

定義

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 の要件

注釈

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

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

• VideoMediaFrame.SoftwareBitmap
• VideoMediaFrame.Direct3DSurface

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

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

バージョン履歴

プロパティ

メソッド

適用対象

こちらもご覧ください

• IClosable
• MediaFrameReader を使ったメディア フレームの処理