MediaCaptureVideoProfile クラス

定義

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 の要件

注釈

ビデオ プロファイルは、特定のキャプチャ デバイスで動作することが保証され、目的のキャプチャ シナリオに合わせて最適化された設定のグループを使用してビデオ キャプチャ デバイスを構成する簡単な方法を提供します。 高品質の写真やビデオのキャプチャ、写真シーケンスのキャプチャ、ビデオ会議など、一般的なシナリオに対してシステムが提供する既知のビデオ プロファイルのセットがあります。 特定のビデオ デバイスの既知のビデオ プロファイルの一覧を取得するには、 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 によって返される値をチェックして、ビデオ プロファイルがキャプチャ デバイスでサポートされていることを確認する必要があります。

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

バージョン履歴

プロパティ

メソッド

適用対象

こちらもご覧ください

• FindKnownVideoProfiles(String, KnownVideoProfile)
• FindAllVideoProfiles(String)
• FindConcurrentProfiles(String)
• MediaCaptureVideoProfileMediaDescription
• カメラ プロファイルを使用したカメラ機能の検出と選択