struktur KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)
Struktur KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION menambahkan alamat dasar buffer, ukuran buffer yang diminta, dan jumlah pemberitahuan ke struktur KSPROPERTY . Struktur ini digunakan oleh klien untuk meminta alokasi buffer audio melalui KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
Sintaks
typedef struct {
KSPROPERTY Property;
PVOID BaseAddress;
ULONG RequestedBufferSize;
ULONG NotificationCount;
} KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION, *PKSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION;
Anggota
Property
Struktur KSPROPERTY yang diinisialisasi klien dengan tepat sebelum memanggil KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
BaseAddress
Menentukan alamat dasar buffer. Kecuali klien menentukan alamat dasar, parameter ini diatur ke NULL.
RequestedBufferSize
Menentukan ukuran buffer dalam byte. Driver mengembalikan ukuran aktual buffer yang dialokasikan dalam struktur KSRTAUDIO_BUFFER yang dikembalikannya.
NotificationCount
Menentukan jumlah pemberitahuan per siklus buffer siklik. Saat ini, nilai yang valid adalah 1 atau 2. Nilai 1 menghasilkan pemberitahuan untuk peristiwa pemberitahuan terdaftar di akhir buffer siklik. Nilai 2 menghasilkan pemberitahuan di titik tengah dan akhir buffer siklik.
Keterangan
Permintaan KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION menggunakan struktur KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION untuk menjelaskan buffer siklik yang diminta klien. Driver mengembalikan struktur KSRTAUDIO_BUFFER untuk menggambarkan buffer yang benar-benar dialokasikan.
Seperti halnya KSPROPERTY_RTAUDIO_BUFFER, nilai yang ditulis klien ke anggota RequestedBufferSize tidak mengikat driver.
Menggunakan KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION memfasilitasi sinyal peristiwa saat DMA berlangsung melalui buffer siklik. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT digunakan untuk mendaftarkan peristiwa untuk menerima pemberitahuan ini dan KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT digunakan untuk membatalkan pendaftaran peristiwa.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows Vista dan sistem operasi Windows yang lebih baru. |
Header | ksmedia.h |
Lihat juga
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION