Compartir a través de


VideoMediaFrame Clase

Definición

Representa un fotograma de un objeto MediaFrameSource que proporciona datos en un fotograma de vídeo representado por un 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
Herencia
Object Platform::Object IInspectable VideoMediaFrame
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

Obtenga una instancia de esta clase accediendo a la propiedad VideoMediaFrame de un objeto MediaFrameReference obtenido de un origen de fotogramas multimedia.

Importante

Si accedes a los objetos SoftwareBitmap o Direct3DSurface proporcionados por la propiedad VideoMediaFrame de una clase MediaFrameReference, el sistema crea una referencia fuerte a estos objetos, lo que significa que no se eliminarán cuando se llamae a Dispose en la clase MediaFrameReference contenedora. Se debe llamar explícitamente al método Dispose de SoftwareBitmap o Direct3DSurface directamente para los objetos que deben eliminarse inmediatamente. De lo contrario, el recolector de elementos no usados al final liberará la memoria de estos objetos, pero no se puede saber cuando ocurrirá, y si el número de superficies o mapas de bits asignados supera la cantidad máxima permitida por el sistema, el nuevo flujo de fotogramas se detendrá. En esa misma línea de pensamiento, si ha llamado a (GetVideoFrame()[videomediaframe_getvideoframe_824740069.md], entonces el (VideoFrame)[.. /windows.media/videoframe.md] recuperado tiene una referencia en los objetos SoftwareBitmap o Direct3DSurface proporcionados por VideoMediaFrame y debe eliminarse llamando manualmente a su método Dispose para evitar bloquear el fow de fotogramas. Si tiene previsto mantener un VideoFrame recuperado a través de (GetVideoFrame()[videomediaframe_getvideoframe_824740069.md] durante un período de tiempo prolongado, puede ser mejor mantener una copia de ella en su lugar.

Para obtener instrucciones de procedimientos sobre el uso de MediaFrameSource para capturar fotogramas, consulte Procesamiento de fotogramas multimedia con MediaFrameReader.

Propiedades

CameraIntrinsics

Obtiene un objeto que describe el modelo de distorsión de la cámara que generó VideoMediaFrame.

DepthMediaFrame

Obtiene un objeto DepthMediaFrame que contiene datos de profundidad para VideoMediaFrame, si el fotograma contiene datos de profundidad.

Direct3DSurface

Obtiene un objeto IDirect3DSurface que contiene los datos de imagen de VideoMediaFrame.

FrameReference

Obtiene el objeto contenedor MediaFrameReference asociado a VideoMediaFrame, que proporciona acceso a la información de formato y a otras propiedades del marco multimedia.

InfraredMediaFrame

Obtiene un Elemento InfraredMediaFrame que contiene datos de profundidad para VideoMediaFrame, si el fotograma contiene datos infrarrojos.

SoftwareBitmap

Obtiene un objeto SoftwareBitmap que contiene los datos de imagen de VideoMediaFrame.

VideoFormat

Obtiene un objeto que describe el formato de los datos de imagen de VideoMediaFrame .

Métodos

GetVideoFrame()

Crea una copia de VideoMediaFrame como un objeto VideoFrame .

Se aplica a

Consulte también