VideoMediaFrame Classe

Definizione

Rappresenta un frame da MediaFrameSource che fornisce dati in un frame video rappresentato da un oggetto IDirect3DSurface o SoftwareBitmap.

public ref class VideoMediaFrame sealed
/// [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 VideoMediaFrame final
[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 VideoMediaFrame
Public NotInheritable Class VideoMediaFrame
Ereditarietà
Object Platform::Object IInspectable VideoMediaFrame
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Commenti

Ottenere un'istanza di questa classe accedendo alla proprietà VideoMediaFrame di un oggetto MediaFrameReference ottenuto da un'origine fotogramma multimediale.

Importante

Se accedi all'oggetto SoftwareBitmap o Direct3DSurface specificato dalla proprietà VideoMediaFrame di un oggetto MediaFrameReference, il sistema crea un riferimento sicuro a questi oggetti, che di conseguenza non vengono eliminati quando chiami Dispose nell'oggetto MediaFrameReference contenitore. Devi chiamare in modo esplicito direttamente il metodo Dispose di SoftwareBitmap o Direct3DSurface perché gli oggetti vengano eliminati immediatamente. In caso contrario, Garbage Collector finirà per liberare la memoria per questi oggetti, ma non saprai quando e se il numero di bitmap o superfici allocate supera la quantità massima consentita dal sistema, il flusso di nuovi fotogrammi si arresterà. In quella stessa linea di pensiero, se hai chiamato (GetVideoFrame())[videomediaframe_getvideoframe_824740069.md], allora il (VideoFrame)[.. /windows.media/videoframe.md] recuperata ha un riferimento sugli oggetti SoftwareBitmap o Direct3DSurface forniti dal VideoMediaFrame e deve essere eliminato chiamando manualmente il metodo Dispose per evitare di bloccare ilow dei fotogrammi. Se si intende conservare in un videoframe recuperato tramite (GetVideoFrame())[videomediaframe_getvideoframe_824740069.md] per un periodo di tempo esteso, potrebbe essere preferibile conservarlo in una copia.

Per indicazioni sull'uso di MediaFrameSource per acquisire fotogrammi, vedere Elaborare fotogrammi multimediali con MediaFrameReader.

Proprietà

CameraIntrinsics

Ottiene un oggetto che descrive il modello di distorsione della fotocamera che ha generato VideoMediaFrame.

DepthMediaFrame

Ottiene un oggetto DepthMediaFrame contenente dati di profondità per VideoMediaFrame, se il frame contiene dati di profondità.

Direct3DSurface

Ottiene un oggetto IDirect3DSurface contenente i dati dell'immagine per VideoMediaFrame.

FrameReference

Ottiene l'oggetto wrapper MediaFrameReference associato a VideoMediaFrame, che fornisce l'accesso alle informazioni di formato e ad altre proprietà del frame multimediale.

InfraredMediaFrame

Ottiene un oggetto InfraredMediaFrame contenente dati di profondità per VideoMediaFrame, se il frame contiene dati a infrarossi.

SoftwareBitmap

Ottiene un oggetto SoftwareBitmap contenente i dati dell'immagine per VideoMediaFrame.

VideoFormat

Ottiene un oggetto che descrive il formato dei dati dell'immagine VideoMediaFrame .

Metodi

GetVideoFrame()

Crea una copia del VideoMediaFrame come oggetto VideoFrame .

Si applica a

Vedi anche