次の方法で共有

MediaCaptureVideoProfile クラス

  • リファレンス

定義

名前空間:
Windows.Media.Capture
編集

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

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 オブジェクトの一覧を取得します。

適用対象

こちらもご覧ください