مرجع بنية audio_stream_in

حقول البيانات
بنية audio_stream_in

#include < audio.h >

حقول البيانات

struct audio_stream   شائعة
 
int(*  set_gain )(struct audio_stream_in *stream, float gain)
 
ssize_t(*  read )(struct audio_stream_in *stream, void *buffer, size_t bytes)
 
uint32_t(*  get_input_frames_lost )(struct audio_stream_in *stream)
 
int(*  get_capture_position )(const struct audio_stream_in *stream, int64_t *frames, int64_t *time)
 

وصف مفصّل

التعريف في السطر 404 من الملف audio.h .

مستندات الحقل

struct audio_stream common

الطرق الشائعة لبث الصوت يجب أن يكون هذا العنصر هو العنصر الأول في audio_stream_in لأنّ مستخدمي هذه البنية سيرسلون إشارة audio_stream إلى مؤشر audio_stream_in في السياقات التي يُعرف فيها أنّ audio_stream يشير إلى audio_stream_in .

التعريف في السطر 410 من الملف audio.h .

int(* get_capture_position)(const struct audio_stream_in *stream, int64_t *frames, int64_t *time)

عرض عدد اللقطات الصوتية التي تم تلقيها مؤخرًا ووقت الساعة المرتبط بعدد اللقطات

frames هو إجمالي عدد اللقطات التي تم استلامها. ويجب إجراء ذلك في أقرب وقت ممكن في مسار الالتقاط. بشكل عام، يجب أن تكون اللقطات غير سالبة وألا تعود إلى الوراء.

الوقت هو الوقت اللامتناهي للساعة عند قياس اللقطات. بشكل عام، يجب أن يكون الوقت كميّة موجبة وألّا يتراجع.

تكون الحالة التي يتم عرضها هي 0 في حال النجاح، أو -ENOSYS إذا لم يكن الجهاز جاهزًا أو متاحًا، أو -EINVAL إذا كانت الوسيطات فارغة أو غير صالحة.

التعريف في السطر 449 من الملف audio.h .

uint32_t(* get_input_frames_lost)(struct audio_stream_in *stream)

عرض عدد لقطات الإدخال التي فقدت في برنامج تشغيل الصوت منذ آخر مرة تم فيها استدعاء هذه الدالة من المتوقّع أن يعيد برنامج تشغيل الصوت ضبط القيمة على 0 ويعيد العدّ عند عرض القيمة الحالية من خلال طلب الدالة هذا. ويحدث هذا الفقدان عادةً عندما يتم حظر عملية مساحة المستخدم لفترة أطول من سعة ذاكرة التخزين المؤقت لبرنامج تشغيل الصوت.

الوحدة: عدد لقطات الصوت المُدخلة

التعريف في السطر 433 من الملف audio.h .

ssize_t(* read)(struct audio_stream_in *stream, void *buffer, size_t bytes)

قراءة ذاكرة التخزين المؤقت للصوت من برنامج تشغيل الصوت تعرِض عدد وحدات البايت المقروءة أو قيمة سالبة لسمة status_t. إذا تم قراءة إطار واحد على الأقل قبل حدوث الخطأ، من المفترض أن تعرِض read عدد وحدات البايت هذا ثم تعرِض خطأ في الطلب اللاحق.

التعريف في السطر 420 من الملف audio.h .

int(* set_gain)(struct audio_stream_in *stream, float gain)

ضبط مستوى كسب الإدخال لبرنامج تشغيل الصوت هذه الطريقة مخصّصة للاستخدام في المستقبل.

التعريف في السطر 414 من الملف audio.h .

تم إنشاء مستندات هذه البنية من الملف التالي:
  • hardware/libhardware/include/hardware/ audio.h