VideoDeviceController クラス

リファレンス

定義

名前空間:: Windows.Media.Devices

重要

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

編集

カメラのデバイス設定を制御します。

public ref class VideoDeviceController sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class VideoDeviceController final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class VideoDeviceController

Public NotInheritable Class VideoDeviceController

継承: Object Platform::Object IInspectable VideoDeviceController

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装: IMediaDeviceController

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

このオブジェクトのインスタンスを取得するには、 MediaCapture.VideoDeviceController プロパティを取得します。

一部のドライバーでは、 VideoDeviceController でサポートされているコントロールを特定する前に、カメラデバイスのプレビューを実行中の状態にする必要がある場合があります。プレビューストリームが実行される前に、特定のコントロールが VideoDeviceController でサポートされているかどうかをチェックした場合、ビデオデバイスでサポートされている場合でも、コントロールがサポートされていないと表示されることがあります。

注意

このクラスはアジャイルではありません。つまり、スレッドモデルとマーシャリング動作を考慮する必要があります。詳細については、「スレッド処理とマーシャリング (C++/CX)」および「マルチスレッド環境でのWindows ランタイムオブジェクトの使用 (.NET)」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	GetDevicePropertyByExtendedId
1703	15063	GetDevicePropertyById
1703	15063	Id
1703	15063	SetDevicePropertyByExtendedId
1703	15063	SetDevicePropertyById
1803	17134	VideoTemporalDenoisingControl
1903	18362	InfraredTorchControl
2004	19041	PanelBasedOptimizationControl

プロパティ

AdvancedPhotoControl	このビデオデバイスの高度な写真キャプチャコントロールを取得します。
BacklightCompensation	カメラでバックライト補正を有効にするかどうかを取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
Brightness	カメラの明るさレベルを取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
CameraOcclusionInfo	カメラの現在のオクルージョン状態を取得し、オクルージョン状態が変化したときに通知を受け取るために使用できる CameraOcclusionInfo オブジェクトを取得します。
Contrast	カメラのコントラストレベルを取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
DesiredOptimization	キャプチャデバイスがビデオキャプチャ中に高品質の画像、低待機時間、または低消費電力を優先するために使用する最適化を示す値を取得または設定します。
DigitalWindowControl	アプリがキャプチャデバイスのセンサーのサブ領域をキャプチャできるようにする DigitalWindowControl を取得します。
Exposure	カメラの露出時間を取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
ExposureCompensationControl	このビデオデバイスの露出補正コントロールを取得します。
ExposureControl	このビデオデバイスの露出コントロールを取得します。
ExposurePriorityVideoControl	VideoDeviceController に関連付けられている ExposurePriorityVideoControl を取得します。
FlashControl	このビデオデバイスのフラッシュコントロールを取得します。
Focus	カメラのフォーカス設定を取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
FocusControl	このビデオデバイスのフォーカスコントロールを取得します。
HdrVideoControl	VideoDeviceController に関連付けられている HdrVideoControl を取得します。これにより、サポートされているデバイスでハイダイナミックレンジ (HDR) ビデオキャプチャモードを有効または無効にすることができます。
Hue	カメラの色相設定を取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
Id	ビデオデバイスコントローラーの識別子を含む文字列を取得します。
InfraredTorchControl	選択したビデオデバイスの赤外線トーチコントロールを取得します。
IsoSpeedControl	このビデオデバイスの ISO フィルム速度コントロールを取得します。
LowLagPhoto	このビデオデバイスの低シャッターラグ写真コントロールを取得します。
LowLagPhotoSequence	このビデオデバイスの低シャッターラグ写真シーケンスコントロールを取得します。
OpticalImageStabilizationControl	VideoDeviceController に関連付けられている OpticalImageStabilizationControl を取得します。
Pan	カメラのパン設定を取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
PanelBasedOptimizationControl	サポートされている場合に、キャプチャデバイスドライバーがカメラのパネルの位置に基づいてカメラキャプチャ機能を最適化できるようにする PanelBasedOptimizationControl を取得します。
PhotoConfirmationControl	このビデオデバイスの写真確認コントロールを取得します。
PrimaryUse	デバイスの主な用途を取得または設定します。
RegionsOfInterestControl	このビデオデバイスの対象領域コントロールを取得します。
Roll	カメラのロール設定を取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
SceneModeControl	このビデオデバイスのシーンモードコントロールを取得します。
Tilt	カメラの傾き設定を取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
TorchControl	このビデオデバイスのトーチコントロールを取得します。
VariablePhotoSequenceController	VideoDeviceController に関連付けられている VariablePhotoSequenceController を取得します。
VideoTemporalDenoisingControl	VideoDeviceController に関連付けられている VideoTemporalDenoisingControl を取得します。これにより、隣接するフレームの画像データを使用して、キャプチャされたビデオのノイズをサポートするデバイスでのノイズの外観を減らすテンポラルノイズ除去を有効または無効にすることができます。
WhiteBalance	カメラのホワイトバランスを取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
WhiteBalanceControl	このビデオデバイスのホワイトバランスコントロールを取得します。
Zoom	カメラのズーム設定を取得または設定するために使用できる MediaDeviceControl オブジェクトを取得します。
ZoomControl	VideoDeviceController に関連付けられている ZoomControl を取得します。

メソッド

GetAvailableMediaStreamProperties(MediaStreamType)	ビデオデバイスでサポートされているエンコードプロパティの一覧を取得します。
GetDeviceProperty(String)	キャプチャデバイスドライバーから、指定した ID を持つプロパティの値を取得します。このメソッドを使用すると、特定のカメラに固有のプロパティに対してクエリを実行できます。
GetDevicePropertyByExtendedId(Byte[], IReference<UInt32>)	カスタムヘッダー情報を含む拡張 ID を使用し、結果を格納するために必要な最大バッファーサイズを指定して、キャプチャデバイスドライバーから指定された ID を持つプロパティの値を取得します。このメソッドを使用すると、特定のカメラに固有のプロパティに対してクエリを実行できます。
GetDevicePropertyById(String, IReference<UInt32>)	カスタムヘッダー情報を含む ID を持つキャプチャデバイスドライバーからプロパティの値を取得します。このメソッドを使用すると、特定のカメラに固有のプロパティに対してクエリを実行できます。
GetMediaStreamProperties(MediaStreamType)	ビデオデバイスの指定したメディアストリームの種類のエンコードプロパティを取得します。
SetDeviceProperty(String, Object)	キャプチャデバイスドライバーで指定した ID を持つプロパティの値を設定します。このメソッドを使用して、特定のカメラに固有のプロパティを設定できます。
SetDevicePropertyByExtendedId(Byte[], Byte[])	カスタムヘッダー情報を含む拡張 ID を使用し、値をバイト配列として指定して、キャプチャデバイスドライバーから指定された ID を持つプロパティの値を設定します。
SetDevicePropertyById(String, Object)	カスタムヘッダー情報を含む拡張 ID を使用し、値をオブジェクトとして指定して、キャプチャデバイスドライバーから指定された ID を持つプロパティの値を設定します。
SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)	ビデオデバイスの指定したメディアストリームの種類に対してエンコードプロパティを非同期的に設定します。
TryAcquireExclusiveControl(String, MediaCaptureDeviceExclusiveControlReleaseMode)	指定したデバイス ID を持つカメラの排他制御を要求します。
TryGetPowerlineFrequency(PowerlineFrequency)	ローカル電源ラインの頻度を取得します。
TrySetPowerlineFrequency(PowerlineFrequency)	ローカル電源ラインの周波数を設定します。

適用対象

こちらもご覧ください

ランプデバイスのサンプル

次の方法で共有