VideoMediaFrame Classe

Définition

Espace de noms:

Windows.Media.Capture.Frames

Représente une image d’un MediaFrameSource qui fournit des données dans une image vidéo représentée par un IDirect3DSurface ou un 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

Héritage

Object Platform::Object IInspectable VideoMediaFrame

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Obtenez un instance de cette classe en accédant à la propriété VideoMediaFrame d’un objet MediaFrameReference obtenu à partir d’une source d’images multimédias.

Important

Si vous accédez aux objets SoftwareBitmap ou Direct3DSurface fournis par la propriété VideoMediaFrame d’un MediaFrameReference, le système crée une référence forte à ces objets. Autrement dit, ils ne sont pas supprimés lorsque vous appelez Dispose sur le conteneur MediaFrameReference. Vous devez appeler la méthode Dispose de SoftwareBitmap ou de Direct3DSurface explicitement et directement pour les objets à supprimer immédiatement. Sinon, le récupérateur de mémoire va libérer de la mémoire pour ces objets. Mais vous ne pouvez pas savoir quand cela se produit, et si le nombre de surfaces ou d’images bitmap allouées dépasse la quantité maximale autorisée par le système, le flux de nouvelles images s’arrête. Dans cette même ligne de pensée, si vous avez appelé (GetVideoFrame())[videomediaframe_getvideoframe_824740069.md], alors le (VideoFrame)[.. /windows.media/videoframe.md] récupéré a une référence sur les objets SoftwareBitmap ou Direct3DSurface fournis par le VideoMediaFrame et doit être éliminé en appelant manuellement sa méthode Dispose pour éviter de bloquer les images. Si vous envisagez de conserver une image vidéo récupérée via (GetVideoFrame())[videomediaframe_getvideoframe_824740069.md] pendant une période prolongée, il peut être préférable de conserver une copie de celle-ci à la place.

Pour obtenir des conseils pratiques sur l’utilisation de MediaFrameSource pour capturer des images, consultez Traiter des trames multimédias avec MediaFrameReader.

Propriétés

CameraIntrinsics	Obtient un objet qui décrit le modèle de distorsion de la caméra qui a généré le VideoMediaFrame.
DepthMediaFrame	Obtient un DepthMediaFrame contenant des données de profondeur pour le VideoMediaFrame, si la trame contient des données de profondeur.
Direct3DSurface	Obtient un objet IDirect3DSurface contenant les données d’image du VideoMediaFrame.
FrameReference	Obtient l’objet wrapper MediaFrameReference associé à VideoMediaFrame, qui permet d’accéder aux informations de format et à d’autres propriétés de l’image multimédia.
InfraredMediaFrame	Obtient un InfraredMediaFrame contenant des données de profondeur pour le VideoMediaFrame, si le cadre contient des données infrarouges.
SoftwareBitmap	Obtient un objet SoftwareBitmap contenant les données d’image du VideoMediaFrame.
VideoFormat	Obtient un objet décrivant le format des données d’image VideoMediaFrame .

Méthodes

GetVideoFrame()

Crée une copie du VideoMediaFrame en tant qu’objet VideoFrame .

Voir aussi

• Traiter des images multimédias avec MediaFrameReader