VideoMediaFrame Clase

Definición

Espacio de nombres:

Windows.Media.Capture.Frames

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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 .

Consulte también

• Procesar fotogramas multimedia con MediaFrameReader