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 を含む) |
こちらもご覧ください
KSPROPERTY_CAMERACONTROL_FLASH_S
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S