KSEVENT_CAMERAEVENT列挙 (ksmedia.h)

KSEVENT_CAMERAEVENT 、ドライバーからのカメラ イベント通知を有効または無効にするためにパイプラインで使用できるカーネル ストリーミング イベント セットを列挙します。

構文

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

定数

KSEVENT_PHOTO_SAMPLE_SCANNED 写真キャプチャのシャッター サウンド再生を同期するためのイベント通知。

注釈

カメラ イベント DDI は 、ドライバーからのカメラ イベント通知を有効または無効にするためにパイプラインで使用できるカーネル ストリーミング イベント セットである KSEVENTSETID_CameraEvent によって定義されます。 これはフィルター レベルのイベントです。つまり、ドライバーは、フィルターのオートメーション テーブルでイベントを実装して定義し、 KsFilterGenerateEvents (またはフィルター オブジェクトを持つ KsGenerateEvents ) を使用してイベント通知を生成する必要があります。

KSEVENTSETID_CameraEvent およびその関連するデータ構造は、Ksmedia.h で次のように定義されます。

#define STATIC_KSEVENTSETID_CameraEvent \
    0x7899b2e0, 0x6b43, 0x4964, 0x9d, 0x2a, 0xa2, 0x1f, 0x40, 0x61, 0xf5, 0x76

DEFINE_GUIDSTRUCT("7899B2E0-6B43-4964-9D2A-A21F4061F576", KSEVENTSETID_CameraEvent);

#define KSEVENTSETID_CameraEvent DEFINE_GUIDNAMED(KSEVENTSETID_CameraEvent)

現在 、KSEVENTSETID_CameraEvent イベント セット KSEVENT_PHOTO_SAMPLE_SCANNEDイベントのみが 定義されています。 パイプラインは、 KSEVENT_PHOTO_SAMPLE_SCANNED イベント通知をサブスクライブしてリッスンし、写真キャプチャのシャッター サウンド再生を同期します。 パイプラインは、特定の写真キャプチャまたは写真シーケンスの最初 のKSEVENT_PHOTO_SAMPLE_SCANNED イベント通知にのみ応答します。 1 回の写真キャプチャまたは写真シーケンス キャプチャに対して 1 回だけシャッター 音が再生され、写真または写真シーケンスキャプチャが完了または停止するまで、後続の通知は無視されます。

このイベント セットは省略可能です。 ドライバーがイベント セットを実装していない場合、写真キャプチャの最初の写真サンプルが DevProxy によって受信されると、パイプラインは既定でシャッター サウンド再生に設定されます。

ドライバーがこのイベント セットを実装する場合、パイプラインはイベントにのみ応答し、写真サンプルを受け取ったときにシャッター サウンドを生成しません。 そのため、ドライバー がこのイベント セット のサポートを実装している場合は、写真サンプルがスキャンされるときに、ドライバーによってKSEVENT_PHOTO_SAMPLE_SCANNEDイベント通知が生成されるようにすることが重要です。

要件

要件	値
Header	ksmedia.h