KSEVENT_CAMERAEVENT列舉 (ksmedia.h)

KSEVENT_CAMERAEVENT 列舉管線可用來啟用或停用驅動程序的相機事件通知的核心串流事件集。

Syntax

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

常數

備註

相機事件 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 事件通知。 它只會針對任何單一相片擷取或相片序列擷取播放一次快門音效，並忽略後續通知，直到相片或相片序列擷取完成或停止為止。

這個事件集是選擇性的。 如果驅動程式未實作事件集，當 DevProxy 收到相片擷取中的第一個相片範例時，管線預設為快門音效播放。

如果驅動程序實作此事件集，管線只會回應事件，且不會在收到相片樣本時產生快門音效。 因此，如果驅動程序實作此事件集的支援，請務必確保驅動程式會在掃描相片範例時產生 KSEVENT_PHOTO_SAMPLE_SCANNED 事件通知。

規格需求