VideoMediaFrame Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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 . |