次の方法で共有

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S構造体 (ksmedia.h)

  • [アーティクル]

PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST カメラ コントロール プロパティ セットの関心領域 (ROI) コントロール プロパティについて説明します。 関心領域は、カメラのフォーカスに使用される画像内の四角形です。 この構造体は、カメラ ドライバーへの要求で使用されるプロパティ値を指定します。

構文

typedef struct {
  RECT  FocusRect;
  BOOL  AutoFocusLock;
  BOOL  AutoExposureLock;
  BOOL  AutoWhitebalanceLock;
  union {
    ULONG Capabilities;
    ULONG Configuration;
  };
} KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S, *PKSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S;

メンバーズ

FocusRect

RECT 構造体。デバイスがフォーカスを設定する四角形の領域を指定します。 この構造は、Windows アプリでのみ使用できます。

FocusRect が有効な値ではない場合、または RECT 構造体のすべてのメンバーがゼロの場合、デバイスはイメージの中心にフォーカスする必要があり、この構造体の残りのメンバーは無視できます。

四角形の座標は、プレビュー ビデオの解像度に関して使用されます。

AutoFocusLock

TRUE 場合、デバイスはフォーカスを現在の値にロックする必要があります。

FocusRect が有効な値でない場合は、このメンバーを無視する必要があります。

AutoExposureLock

TRUE 場合、デバイスは現在の値への露出をロックする必要があります。

FocusRect が有効な値でない場合は、このメンバーを無視する必要があります。

AutoWhitebalanceLock

TRUE 場合、デバイスはホワイト バランス設定を現在の値にロックする必要があります。

FocusRect が有効な値でない場合は、このメンバーを無視する必要があります。

Capabilities

デバイスとドライバーが対象地域の設定を自動的にサポートするか、手動でサポートするかを示します。 このメンバーは、次の使用可能な値のビットごとの OR。

価値 意味
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO デバイスとドライバーは、関心のある領域を自動的に設定できます。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL ユーザーは、関心のある地域を手動で設定できます。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC ROI 制御機能は非同期的に実行されます。 この機能は、Windows 8.1 以降で使用できます。

Configuration

リージョンの制御操作の構成フラグ。 これは、次の値のビットごとの OR の組み合わせです。

このメンバーは、Windows 8.1 以降で使用できます。

価値 意味
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS 領域の自動フォーカスを設定します。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE 領域の自動露出を設定します。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB リージョンの自動ホワイト バランスを設定します。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE 領域内のオブジェクトの収束を有効にします。

必要条件

要件 価値
サポートされる最小クライアント Windows 8
サポートされる最小サーバー Windows Server 2012
ヘッダー ksmedia.h (Ksmedia.h を含む)

関連項目

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECTの