VideoMediaFrame 클래스

정의

네임스페이스:

Windows.Media.Capture.Frames

IDirect3DSurface 또는 SoftwareBitmap으로 표시되는 비디오 프레임에 데이터를 제공하는 MediaFrameSource의 프레임을 나타냅니다.

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

상속

Object Platform::Object IInspectable VideoMediaFrame

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

설명

미디어 프레임 원본에서 가져온 MediaFrameReference 개체의 VideoMediaFrame 속성에 액세스하여 이 클래스의 instance 가져옵니다.

중요

MediaFrameReference의 VideoMediaFrame 속성에서 제공하는 SoftwareBitmap 또는 Direct3DSurface 개체에 액세스하는 경우 시스템은 이러한 개체에 대한 강력한 참조를 만듭니다. 즉, 포함된 MediaFrameReference에서 Dispose를 호출할 때 삭제되지 않습니다. 개체를 즉시 삭제하려면 SoftwareBitmap 또는 Direct3DSurface의 Dispose 메서드를 직접 명시적으로 호출해야 합니다. 그러지 않으면 가비지 수집기에서 결국 이러한 개체의 메모리를 해제하지만 언제 수행될지 알 수 없으며, 할당된 비트맵 또는 화면 수가 시스템에서 허용된 최대 크기를 초과할 경우 새 프레임의 흐름이 중단됩니다. 동일한 생각 줄에서 (GetVideoFrame())[videomediaframe_getvideoframe_824740069.md]를 호출한 경우 (VideoFrame)[.. 검색된 /windows.media/videoframe.md]에는 VideoMediaFrame에서 제공하는 SoftwareBitmap 또는 Direct3DSurface 개체에 대한 참조가 있으며 프레임의 파종을 차단하지 않도록 Dispose 메서드를 수동으로 호출하여 삭제해야 합니다. (GetVideoFrame())[videomediaframe_getvideoframe_824740069.md]를 통해 검색된 VideoFrame을 장기간 유지하려는 경우 대신 복사본을 유지하는 것이 더 좋을 수 있습니다.

MediaFrameSource를 사용하여 프레임을 캡처하는 방법에 대한 방법 지침은 MediaFrameReader를 사용하여 미디어 프레임 처리를 참조하세요.

속성

CameraIntrinsics	VideoMediaFrame을 생성한 카메라의 왜곡 모델을 설명하는 개체를 가져옵니다.
DepthMediaFrame	프레임에 깊이 데이터가 포함된 경우 VideoMediaFrame에 대한 깊이 데이터가 포함된 DepthMediaFrame을 가져옵니다.
Direct3DSurface	VideoMediaFrame에 대한 이미지 데이터를 포함하는 IDirect3DSurface 개체를 가져옵니다.
FrameReference	미디어 프레임의 형식 정보 및 기타 속성에 대한 액세스를 제공하는 VideoMediaFrame과 연결된 MediaFrameReference 래퍼 개체를 가져옵니다.
InfraredMediaFrame	프레임에 적외선 데이터가 포함된 경우 VideoMediaFrame에 대한 깊이 데이터가 포함된 적외선 미디어 프레임을 가져옵니다.
SoftwareBitmap	VideoMediaFrame에 대한 이미지 데이터를 포함하는 SoftwareBitmap 개체를 가져옵니다.
VideoFormat	VideoMediaFrame 이미지 데이터의 형식을 설명하는 개체를 가져옵니다.

메서드

GetVideoFrame()

VideoMediaFrame의 복사본을 VideoFrame 개체로 만듭니다.

추가 정보

• MediaFrameReader를 사용하여 미디어 프레임 처리