Bagikan melalui


VideoMediaFrame Kelas

Definisi

Mewakili bingkai dari MediaFrameSource yang menyediakan data dalam bingkai video yang diwakili oleh IDirect3DSurface atau 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
Warisan
Object Platform::Object IInspectable VideoMediaFrame
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

Dapatkan instans kelas ini dengan mengakses properti VideoMediaFrame dari objek MediaFrameReference yang diperoleh dari sumber bingkai media.

Penting

Jika Anda mengakses objek SoftwareBitmap atau Direct3DSurface yang disediakan oleh properti VideoMediaFrame dari MediaFrameReference, sistem membuat referensi yang kuat ke objek ini, yang berarti bahwa objek tersebut tidak akan dibuang saat Anda memanggil Buang pada MediaFrameReference yang berisi. Anda harus secara eksplisit memanggil metode BuangSoftwareBitmap atau Direct3DSurface secara langsung agar objek segera dibuang. Jika tidak, pengumpul sampah pada akhirnya akan membebaskan memori untuk objek-objek ini, tetapi Anda tidak dapat tahu kapan ini akan terjadi, dan jika jumlah bitmap atau permukaan yang dialokasikan melebihi jumlah maksimum yang diizinkan oleh sistem, aliran bingkai baru akan berhenti. Dalam pemikiran yang sama, jika Anda telah memanggil (GetVideoFrame())[videomediaframe_getvideoframe_824740069.md], maka (VideoFrame)[.. /windows.media/videoframe.md] yang diambil memiliki referensi pada objek SoftwareBitmap atau Direct3DSurface yang disediakan oleh VideoMediaFrame dan perlu dibuang dengan memanggil secara manual metode Buang untuk menghindari pemblokiran umpatan bingkai. Jika Anda berniat untuk berpegang pada VideoFrame yang diambil melalui (GetVideoFrame()[videomediaframe_getvideoframe_824740069.md] untuk jangka waktu yang lama, mungkin lebih baik untuk berpegang pada salinannya sebagai gantinya.

Untuk panduan cara menggunakan MediaFrameSource untuk mengambil bingkai, lihat Memproses bingkai media dengan MediaFrameReader.

Properti

CameraIntrinsics

Mendapatkan objek yang menjelaskan model distorsi kamera yang menghasilkan VideoMediaFrame.

DepthMediaFrame

Mendapatkan DepthMediaFrame yang berisi data kedalaman untuk VideoMediaFrame, jika bingkai berisi data kedalaman.

Direct3DSurface

Mendapatkan objek IDirect3DSurface yang berisi data gambar untuk VideoMediaFrame.

FrameReference

Mendapatkan objek pembungkus MediaFrameReference yang terkait dengan VideoMediaFrame, yang menyediakan akses ke informasi format dan properti lain dari bingkai media.

InfraredMediaFrame

Mendapatkan InfraredMediaFrame yang berisi data kedalaman untuk VideoMediaFrame, jika bingkai berisi data inframerah.

SoftwareBitmap

Mendapatkan objek SoftwareBitmap yang berisi data gambar untuk VideoMediaFrame.

VideoFormat

Mendapatkan objek yang menjelaskan format data gambar VideoMediaFrame .

Metode

GetVideoFrame()

Membuat salinan VideoMediaFrame sebagai objek VideoFrame .

Berlaku untuk

Lihat juga