KS Olayları

AVStream minidriver yazıyorsanız bkz. AVStream'de Olay İşleme.

Olay kümeleri, dinleyicinin bildirim isteyebileceği ilgili olay gruplarıdır. Örneğin, bir dinleyici cihaz durumu değişiklikleri veya akış konumundaki değişikliklerden haberdar olmak için kaydolabilir. Bir olay meydana geldiğinde, çekirdek akış teknolojisi bu olaya kayıtlı olan tüm istemcilere bildirir.

Minidriver'lar, yordamları işlemeye yönelik işaretçiler içeren bir KSEVENT_ITEM yapısı sağlayarak bir olayı nasıl desteklediklerini açıklar.

Dinleyiciler, IOCTL_KS_ENABLE_EVENT denetim kodu ve KSEVENT ve KSEVENTDATA yapılarına ait işaretçilerle çekirdek akış proxy yordamı KsSynchronousDeviceControl'ü çağırarak bildirime kaydolur.

IOCTL_KS_DISABLE_EVENT isteği belirtilen bir olayı devre dışı bırakır. Olayı etkinleştirmek için kullanılan işaretçinin, olayı devre dışı bırakmak için de kullanılması gerekir. Bu işaretçi olayı benzersiz olarak tanımlar. İsteğe bağlı olarak, istemci tüm etkin olayları devre dışı bırakmak için bir NULL işaretçisi ve sıfır uzunluk belirtebilir.

Tüm olay kümeleri KSEVENT_TYPE_BASICSUPPORT bayrağını desteklemelidir. Kullanılabilir olay bayraklarının listesi için KSEVENT'e bakın.

Bazı olay türleri, olay bildirimine kaydolmak için ek parametreler gerektirir. Örneğin, bir saat üzerindeki KSEVENT_CLOCK_POSITION_MARK olayı, saat belirli bir zaman damgasına ulaştığında tetiklenir. Sonuç olarak, bu olayla ilgili bildirim almak üzere kaydolan istemcilerin olayın tetiklenecek zaman damgasını belirtmesi gerekir.

Böyle bir durumda, bir mini sürücü KSEVENTDATA yapısından sonra veri arabelleğine ek veri parametreleri geçirir. Böyle bir olay türünü destekleyen minidriver'lar, bildirim verilerini tutmak için ilk üyenin KSEVENTDATA türünde olduğu genişletilmiş bir veri yapısı kullanır.