KSPROPERTY_CAMERACONTROL_S_EX構造体 (ksmedia.h)

  • [アーティクル]

フラッシュの設定、イメージ ピンコントロールプロパティ、画像の対象領域、ビデオ安定化などのカメラコントロール操作を指定します。 この構造体では、 PROPSETID_VIDCAP_CAMERACONTROL プロパティ セット内のフィルターベースのプロパティについて説明します。

Windows 8 以降でサポートされています。

構文

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

メンバー

Property

プロパティ セット、プロパティ ID、および要求の種類を記述する、初期化された KSPROPERTY 構造体を指定します。

Value

プロパティの値を指定します。 このメンバーは読み取り/書き込みです。

Flags

Get 要求の場合、指定したプロパティの現在の設定を以下に示す値から示します。 [Set requests]\(要求の設定\) で、指定したプロパティに対して次に示す値の目的の設定を示します。 このメンバーには、Ksmedia.h で定義されている次の値のビットごとの OR を指定できます。

値 説明
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO 設定が自動的に制御されることを示します。 ドライバーがこの値を受け取った場合は、カメラ コントロールを同期的に自動モードに設定してから、 を返す必要があります。
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL 設定が手動で制御されることを示します。 ドライバーがこの値を受け取った場合は、カメラ コントロールを同期的に手動モードに設定してから、 を返す必要があります。
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS ドライバーがカメラコントロール操作を非同期的に実行する必要があるかどうかを示します。ここで、アプリケーションは、写真を撮る前にカメラコントロール設定を設定するためのコマンドをドライバーに発行しました。 このフラグは、 KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL または KSPROPERTY_CAMERACONTROL_FLAGS_AUTO が設定されている場合にのみ設定する必要があります。 このフラグ値と KSPROPERTY_CAMERACONTROL_FLAGS_AUTO フラグ値の両方が設定されている場合、ドライバーは、1 つの要求された制御操作を開始するワーカー スレッドを開始する必要があります。最初の操作が完了するまで、同じ操作に対する他のすべての要求を拒否する必要があります。 操作が正常に完了すると、ドライバーは KSEVENTSETID_CameraAsyncControl イベントをトリガーする必要があります。

Capabilities

が設定されている場合、アプリケーションがクエリを送信すると、ドライバーは次の一覧から適切なカメラコントロール構造の Capabilities メンバーの値を返す必要があることを示します。

FocusRect

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

注釈

要求されたカメラ フォーカス操作が完了するか、取り消されると、ドライバーは KSEVENT_CAMERACONTROL_FOCUS 列挙値で指定されたイベントを生成する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
Header ksmedia.h (Ksmedia.h を含む)

こちらもご覧ください

KSEVENT_CAMERACONTROL

KSPROPERTY

KSPROPERTY_CAMERACONTROL_FLASH_S

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S

KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S

Rect