VideoMediaFrame Kelas

Definisi

Ruang nama:

Windows.Media.Capture.Frames

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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 .

Lihat juga

• Memproses bingkai media dengan MediaFrameReader