VideoDeviceController クラス

定義

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

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
属性
実装

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)

ローカル電源ラインの周波数を設定します。

適用対象

こちらもご覧ください