MediaCaptureVideoProfile クラス

リファレンス

定義

名前空間:: Windows.Media.Capture

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

ビデオキャプチャデバイスでサポートされている構成を示すビデオプロファイルを表します。

public ref class MediaCaptureVideoProfile sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaCaptureVideoProfile final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaCaptureVideoProfile

Public NotInheritable Class MediaCaptureVideoProfile

継承: Object Platform::Object IInspectable MediaCaptureVideoProfile

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)
アプリの機能	backgroundMediaRecording

注釈

ビデオプロファイルは、特定のキャプチャデバイスで動作することが保証され、目的のキャプチャシナリオに合わせて最適化された設定のグループを使用してビデオキャプチャデバイスを構成する簡単な方法を提供します。高品質の写真やビデオのキャプチャ、写真シーケンスのキャプチャ、ビデオ会議など、一般的なシナリオに対してシステムが提供する既知のビデオプロファイルのセットがあります。特定のビデオデバイスの既知のビデオプロファイルの一覧を取得するには、 MediaCapture.FindKnownVideoProfiles を使用します。一部のハードウェアベンダーは、 MediaCapture.FindAllVideoProfiles を呼び出すことによって取得できる他のビデオプロファイルを公開する場合があります。

ビデオプロファイルは、 MediaCaptureVideoProfileMediaDescription オブジェクト、 SupportedPhotoMediaDescription、 SupportedPreviewMediaDescription、 SupportedRecordMediaDescription の 3 つのリストを公開します。これらのリストの各項目は、対応する操作でサポートされている設定のグループです。たとえば、1 つのビデオプロファイルで、HDR ビデオをサポートして 30 fps で 720p ビデオを記録したり、HDR ビデオをサポートせずに 30 fps で 1080p ビデオを記録したりすることもできます。この場合、これらのそれぞれは、ビデオプロファイルの SupportedRecordMediaDescription リストの MediaCaptureVideoProfileMediaDescription オブジェクトによって表されます。

MediaCaptureInitializationSettings オブジェクトを使用して、特定のビデオプロファイルを使用するようにキャプチャデバイスを構成します。デバイスの構成時に使用するビデオプロファイルが、他の初期化設定と互換性を持っていることが重要です。 MediaCaptureInitializationSettings でメディアプロファイルの説明を正しく使用する方法の詳細については、「MediaCaptureInitializationSettings.VideoProfile」を参照してください。

ビデオプロファイルを使用する前に、MediaCapture.IsVideoProfileSupported によって返される値をチェックして、ビデオプロファイルがキャプチャデバイスでサポートされていることを確認する必要があります。

ビデオプロファイルを操作するためのハウツーガイダンスについては、「カメラプロファイルを使用してカメラ機能を検出して選択する」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1803	17134	FrameSourceInfos
1803	17134	Properties

プロパティ

FrameSourceInfos	MediaFrameSource の機能の詳細を提供する MediaFrameSourceInfo オブジェクトの読み取り専用リストを取得します。
Id	ビデオプロファイルの一意識別子を取得します。
Properties	キャプチャデバイスの製造元によって提供されるカスタム属性の読み取り専用マップを取得します。
SupportedPhotoMediaDescription	写真キャプチャでサポートされているビデオデバイス設定を表す MediaCaptureVideoProfileMediaDescription オブジェクトの一覧を取得します。
SupportedPreviewMediaDescription	ビデオプレビューでサポートされているビデオデバイス設定を表す MediaCaptureVideoProfileMediaDescription オブジェクトの一覧を取得します。
SupportedRecordMediaDescription	ビデオ録画でサポートされているビデオデバイス設定を表す MediaCaptureVideoProfileMediaDescription オブジェクトの一覧を取得します。
VideoDeviceId	ビデオプロファイルに関連付けられているビデオデバイスのデバイス ID を取得します。

メソッド

GetConcurrency()

このビデオプロファイルと同時に使用できる MediaCaptureVideoProfile オブジェクトの一覧を取得します。

適用対象