VideoMediaFrame Classe

Definizione

Spazio dei nomi:

Windows.Media.Capture.Frames

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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 .

Vedi anche

• Elaborare fotogrammi multimediali con MediaFrameReader