KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

Artikel
06/15/2023

Properti KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT membatalkan pendaftaran peristiwa mode pengguna dari pemberitahuan peristiwa berbasis DMA.

Tabel berikut ini meringkas fitur properti ini.

Tabel Ringkasan Penggunaan

Dapatkan	Set	Target	Jenis deskriptor properti	Jenis nilai properti
Ya	Ya	Menyematkan	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

Deskriptor properti (data instans) terdiri dari struktur KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY yang berisi struktur KSPROPERTY bersama dengan handel peristiwa mode pengguna.

Nilai properti (data operasi) untuk properti ini adalah NULL karena tidak ada data operasi yang dikembalikan.

Nilai Yang Dikembalikan

Permintaan properti KSPROPERTY_ RTAUDIO_UNREGISTER_NOTIFICATION_EVENT mengembalikan STATUS_SUCCESS untuk menunjukkan bahwa permintaan telah berhasil diselesaikan. Jika tidak, permintaan mengembalikan kode status kegagalan yang sesuai. Tabel berikut ini memperlihatkan beberapa kemungkinan kode status kegagalan.

Kode status	Makna
STATUS_NOT_SUPPORTED	Pemberitahuan peristiwa tidak didukung.
STATUS_INSUFFICIENT_RESOURCES	Memori untuk buffer tidak dapat dialokasikan.
STATUS_DEVICE_NOT_READY	Perangkat belum siap.

Keterangan

Properti ini digunakan untuk membatalkan pendaftaran peristiwa mode pengguna dari pemberitahuan peristiwa berbasis DMA.

Ketika pin ditempatkan ke dalam status eksekusi (KSSTATE_RUN) peristiwa terdaftar diberi sinyal sekali atau dua kali per siklus buffer audio siklik, tergantung pada jumlah pemberitahuan yang diminta saat KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION dipanggil. Untuk informasi selengkapnya tentang KSSTATE_RUN, lihat topik Transisi Status .

Setelah Anda menghentikan pin dan sebelum langkah di mana Anda menutupnya, setiap peristiwa terdaftar harus dibatalkan pendaftarannya melalui panggilan ke KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.