nl:: Weave:: النظام:: النظام الأساسي:: الطبقة
الملخّص
الدوال |
|
---|---|
DidInit(Layer & aLayer, void *aContext, Error aStatus)
|
NL_DLL_EXPORT void
هذا عنصر جذب بعد إعداد نظام Weave لنظام أساسي.
|
DidShutdown(Layer & aLayer, void *aContext, Error aStatus)
|
NL_DLL_EXPORT void
هذا عنصر جذب للطبقة لنظام تضمين في نظام Weave لنظام التشغيل الأساسي.
|
DispatchEvent(Layer & aLayer, void *aContext, Event aEvent)
|
NL_DLL_EXPORT Error
هو حدث مخصّص للنظام الأساسي / حدث مخصّص لإرسال الرسائل.
|
DispatchEvents(Layer & aLayer, void *aContext)
|
NL_DLL_EXPORT Error
هو حدث مخصّص للنظام الأساسي / حدث مخصّص لإرسال الرسائل.
|
GetClock_Monotonic(void)
|
uint64_t
وظيفة خاصة بالنظام الأساسي للحصول على وقت النظام الأحادي في الثانية.
|
GetClock_MonotonicHiRes(void)
|
uint64_t
وظيفة خاصة بالنظام الأساسي للحصول على وقت نظام أحادي الصوت عالي الدقة بالميكروثانية.
|
GetClock_MonotonicMS(void)
|
uint64_t
دالة خاصة بالنظام الأساسي للحصول على وقت النظام الأحادي في مللي ثانية.
|
GetClock_RealTime(uint64_t & curTime)
|
Error
دالة خاصة بالنظام الأساسي للحصول على الوقت الفعلي (المدني) الحالي بتنسيق توقيت Unix للميكرو ثانية.
|
GetClock_RealTimeMS(uint64_t & curTimeMS)
|
Error
دالة مخصّصة للنظام الأساسي لمعرفة الوقت الفعلي (المدني) الحالي بتنسيق يونكس الزمني بالمللي ثانية.
|
PostEvent(Layer & aLayer, void *aContext, Object & aTarget, EventType aType, uintptr_t aArgument)
|
NL_DLL_EXPORT Error
هذا هو حدث / رسالة مشاركة خاصة بالنظام الأساسي.
|
SetClock_RealTime(uint64_t newCurTime)
|
Error
دالة خاصة بالنظام الأساسي لإعداد الوقت الحالي (المدني) الحالي.
|
StartTimer(Layer & aLayer, void *aContext, uint32_t aMilliseconds)
|
NL_DLL_EXPORT Error
هو حدث مخصّص للنظام الأساسي / حدث مخصّص لإرسال الرسائل.
|
WillInit(Layer & aLayer, void *aContext)
|
NL_DLL_EXPORT Error
هذا عنصر بدء الإعداد المسبق لنظام Weave لنظام النظام الأساسي.
|
WillShutdown(Layer & aLayer, void *aContext)
|
NL_DLL_EXPORT Error
هذا عنصر جذب للطبقة لنظام تضمين في نظام Weave لنظام التشغيل الأساسي.
|
الدوال
CANNOT TRANSLATE
NL_DLL_EXPORT void DidInit( Layer & aLayer, void *aContext, Error aStatus )
هذا عنصر جذب بعد إعداد نظام Weave لنظام أساسي.
يمكن إلغاء ذلك من خلال الحصول على تعريف معالج المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_XTOR_FunctionS.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
إيقاف التشغيل
NL_DLL_EXPORT void DidShutdown( Layer & aLayer, void *aContext, Error aStatus )
هذا عنصر جذب للطبقة لنظام تضمين في نظام Weave لنظام التشغيل الأساسي.
يمكن إلغاء ذلك من خلال الحصول على تعريف معالج المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_XTOR_FunctionS.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
المرتجعات |
WEAVE_SYSTEM_NO_ERROR في حالة النجاح، أو حدث خطأ محدد يشير إلى سبب إخفاق الإغلاق. وسيؤدي إرجاع الحالة غير الناجحة إلى إلغاء عملية الإيقاف.
|
الحدث المرسَل
NL_DLL_EXPORT Error DispatchEvent( Layer & aLayer, void *aContext, Event aEvent )
هو حدث مخصّص للنظام الأساسي / حدث مخصّص لإرسال الرسائل.
يمكن تجاوز ذلك من خلال الحصول على تعريف المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_EVENT_FunctionS.
ينقل هذا الحدث المحدّد للمعالجة مع إلغاء تجزئة النوع والوسيطات من الحدث وإرساله إلى نظام Weave System Layer::HandleEvent للإرسال الفعلي.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||
قيم الإرجاع |
|
إرسال الأحداث
NL_DLL_EXPORT Error DispatchEvents( Layer & aLayer, void *aContext )
هو حدث مخصّص للنظام الأساسي / حدث مخصّص لإرسال الرسائل.
يمكن تجاوز ذلك من خلال الحصول على تعريف المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_EVENT_FunctionS.
ويؤثّر ذلك في تكرار الأحداث، والانتظار في قائمة انتظار تقدِّم هذا المثيل، وسحب الأحداث من قائمة الانتظار هذه، ثم إرسالها للتسليم.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||
قيم الإرجاع |
|
GetClock_Monotonic
uint64_t GetClock_Monotonic( void )
وظيفة خاصة بالنظام الأساسي للحصول على وقت النظام الأحادي في الثانية.
ومن المتوقّع أن تعرض هذه الدالة الوقت المنقضي بالميكرو ثانية منذ حقبة عشوائية مُحدَّدة في النظام الأساسي. عمليات تنفيذ النظام الأساسي مُلزَمة بعرض قيمة تتزايد باستمرار (أي لا يحدث مطلقًا) بين عمليات إعادة تشغيل النظام. وبالإضافة إلى ذلك، فإن مصدر الوقت الأساسي مطلوب لوضع علامة مستمرة أثناء أي أوضاع نوم النظام لا تؤدي إلى إعادة التشغيل عند التنشيط.
ليس يُطلب من الحقبة الزمنية التي تعرضها هذه الدالة أن تكون هي نفسها لأي من وظائف GetClock الأخرى...، بما فيها GetClock_MonotonicMS().
من المتوقع أن تكون هذه الوظيفة آمنة في سلسلة محادثات على أي نظام أساسي يستخدم سلاسل المحادثات.
التفاصيل | |
---|---|
المرتجعات |
الوقت المنقضي بالميكروثانية منذ حقبة عشوائية من منصة تحدّدها المنصّة.
|
GetClock_MonotonicHiRes
uint64_t GetClock_MonotonicHiRes( void )
وظيفة خاصة بالنظام الأساسي للحصول على وقت نظام أحادي الصوت عالي الدقة بالميكروثانية.
ومن المتوقّع أن تعرض هذه الدالة الوقت المنقضي بالميكرو ثانية منذ حقبة عشوائية مُحدَّدة في النظام الأساسي. يجب أن تكون القيم التي تعرضها GetClock_MonotonicHiRes() تزداد باستمرار (أي لا يحدث التفاف مطلقًا). يُرجى العِلم بأنّ الموقّت المضمّن ليس مطلوبًا لوضع علامة عليه بشكل مستمر أثناء حالة السكون العميق للنظام.
ويتم تشجيع النظام الأساسي على تنفيذ GetClock_MonotonicHiRes() باستخدام موقِّت عالي الدقة لا يخضع لتعديلات الساعة التدريجية (التقلب). على المنصّات التي لا تتضمّن هذا الموقّت، يمكن أن تعرض GetClock_MonotonicHiRes() القيمة نفسها لـ GetClock_Monotonic().
ليس بالضرورة أن تكون الحقبة الزمنية التي تعرضها هذه الدالة هي نفسها لأي من وظائف GetClock الأخرى....
من المتوقع أن تكون هذه الوظيفة آمنة في سلسلة محادثات على أي نظام أساسي يستخدم سلاسل المحادثات.
التفاصيل | |
---|---|
المرتجعات |
الوقت المنقضي بالميكروثانية منذ حقبة عشوائية من منصة تحدّدها المنصّة.
|
GetClock_MonotonicMS
uint64_t GetClock_MonotonicMS( void )
دالة خاصة بالنظام الأساسي للحصول على وقت النظام الأحادي في مللي ثانية.
ومن المتوقع أن تعرض هذه الدالة الوقت المنقضي بالمللي ثانية منذ حقبة عشوائية مُحدَّدة من النظام الأساسي. عمليات تنفيذ النظام الأساسي مُلزَمة بعرض قيمة تتزايد باستمرار (أي لا يحدث مطلقًا) بين عمليات إعادة تشغيل النظام. وبالإضافة إلى ذلك، فإن مصدر الوقت الأساسي مطلوب لوضع علامة مستمرة أثناء أي أوضاع نوم النظام لا تؤدي إلى إعادة التشغيل عند التنشيط.
ليس نهاية الفترة الزمنية التي تعرضها هذه الدالة هي نفس المدة الزمنية لأي من وظائف GetClock الأخرى...، بما في ذلك GetClock_Monotonic().
من المتوقع أن تكون هذه الوظيفة آمنة في سلسلة محادثات على أي نظام أساسي يستخدم سلاسل المحادثات.
التفاصيل | |
---|---|
المرتجعات |
الوقت المنقضي بالمللي ثانية منذ حقبة عشوائية مُحدَّدة في النظام الأساسي.
|
الحصول على الوقت الفعلي
Error GetClock_RealTime( uint64_t & curTime )
دالة خاصة بالنظام الأساسي للحصول على الوقت الفعلي (المدني) الحالي بتنسيق توقيت Unix للميكرو ثانية.
من المتوقع أن تعرض هذه الدالة النظام الأساسي المحلي في الوقت الفعلي، معبرًا عنه بقيمة وقت Unix يتم قياسها بالميكرو ثانية. يجب تفعيل الساعة الأساسية للإشارة إلى معدّل الثواني الكاملة على الأقل (القيم 1,000,000)، ولكن قد تنقّل بسرعة أكبر.
على هذه الأنظمة الأساسية التي يمكنها تتبع الوقت الفعلي، يجب أن تعرض GetClock_ RealTime() الخطأ WEAVE_SYSTEM_ERROR_REAL_TIME_NOT_SYNCED عندما لا تتم مزامنة النظام مع الوقت الفعلي.
يجب ألا تنفّذ المنصات التي يتعذّر عليها تتبّع الوقت الفعلي وظيفة الدالة GetClock_ RealTime() ، ما يؤدي إلى فرض حالات تعذُّر ربط الروابط بالميزات التي تعتمد على الوصول إلى الوقت الفعلي. وبدلاً من ذلك، قد توفّر هذه الأنظمة الأساسية تنفيذ GetClock_ RealTime() الذي يؤدي إلى عرض الخطأ WEAVE_SYSTEM_ERROR_NOT_SUPPORTED.
من المتوقع أن تكون هذه الوظيفة آمنة في سلسلة محادثات على أي نظام أساسي يستخدم سلاسل المحادثات.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
GetClock_RealTimeMS
Error GetClock_RealTimeMS( uint64_t & curTimeMS )
دالة مخصّصة للنظام الأساسي لمعرفة الوقت الفعلي (المدني) الحالي بتنسيق يونكس الزمني بالمللي ثانية.
من المتوقع أن تعرض هذه الدالة النظام الأساسي المحلي في الوقت الفعلي، معبرًا عنه بقيمة وقت Unix يتم قياسها بالمللي ثانية.
راجِع وثائق GetClock_ RealTime() لمعرفة تفاصيل عن السلوك المتوقَّع.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
ما بعد الفعالية
NL_DLL_EXPORT Error PostEvent( Layer & aLayer, void *aContext, Object & aTarget, EventType aType, uintptr_t aArgument )
هذا هو حدث / رسالة مشاركة خاصة بالنظام الأساسي.
يمكن تجاوز ذلك من خلال الحصول على تعريف المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_EVENT_FunctionS.
يؤدي هذا إلى نشر حدث / رسالة من النوع المحدد مع الوسيطة المتوفرة إلى هذه المثيل الخاص بالحدث / قائمة الانتظار الخاصة بالنظام الأساسي.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||||
المرتجعات |
WEAVE_SYSTEM_NO_ERROR في حالة النجاح، أو حدث خطأ محدد يشير إلى سبب إخفاق الإعداد.
|
ضبط CClock_الوقت الفعلي
Error SetClock_RealTime( uint64_t newCurTime )
دالة خاصة بالنظام الأساسي لإعداد الوقت الحالي (المدني) الحالي.
نسمي هذا الدالة هذه الدالة لضبط مفهوم النظام الأساسي المحلي في الوقت الفعلي الحالي. يتم التعبير عن الوقت الحالي الجديد بقيمة وقت Unix بمقدار ميكرو ثانية.
بعد ضبط السياسة، من المتوقّع أن تتتبّع ساعة المنصة الأساسية في الوقت الفعلي بدقة تبلغ على الأقل ثوانٍ كاملة.
على الأنظمة الأساسية التي تتيح التتبّع في الوقت الفعلي، يجب أن تعرض دالة SetClock_ RealTime() الخطأ WEAVE_SYSTEM_ERROR_ACCESS_DENIED إذا لم يكن لدى تطبيق الاتصال امتياز ضبط الوقت الحالي.
يجب ألا تنفّذ المنصات التي لا يمكنها تتبّع الوقت الفعلي أو التي لا توفّر إمكانية ضبط الوقت الفعلي دالة {0}SetClock_ RealTime(، وبالتالي يتم فرض حالات تعذُّر وقت الربط للميزات التي تعتمد على إعداد الوقت الفعلي. وبدلاً من ذلك، قد توفّر هذه الأنظمة الأساسية تنفيذ SetClock_ RealTime() الذي يؤدي إلى عرض الخطأ WEAVE_SYSTEM_ERROR_NOT_SUPPORTED.
من المتوقع أن تكون هذه الوظيفة آمنة في سلسلة محادثات على أي نظام أساسي يستخدم سلاسل المحادثات.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
StartTimer
NL_DLL_EXPORT Error StartTimer( Layer & aLayer, void *aContext, uint32_t aMilliseconds )
هو حدث مخصّص للنظام الأساسي / حدث مخصّص لإرسال الرسائل.
يمكن تجاوز ذلك من خلال الحصول على تعريف المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_EVENT_FunctionS.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
ويل إنيت
NL_DLL_EXPORT Error WillInit( Layer & aLayer, void *aContext )
هذا عنصر بدء الإعداد المسبق لنظام Weave لنظام النظام الأساسي.
يمكن إلغاء ذلك من خلال الحصول على تعريف معالج المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_XTOR_FunctionS.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
المرتجعات |
WEAVE_SYSTEM_NO_ERROR في حالة النجاح، أو حدث خطأ محدد يشير إلى سبب إخفاق الإعداد. وسيؤدي إرجاع الحالة غير الناجحة إلى إلغاء الإعداد.
|
إيقاف التشغيل
NL_DLL_EXPORT Error WillShutdown( Layer & aLayer, void *aContext )
هذا عنصر جذب للطبقة لنظام تضمين في نظام Weave لنظام التشغيل الأساسي.
يمكن إلغاء ذلك من خلال الحصول على تعريف معالج المعالج المسبق، WEAVE_SYSTEM_CONFIG_PLATFORM_PROVIDES_XTOR_FunctionS.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
المرتجعات |
WEAVE_SYSTEM_NO_ERROR في حالة النجاح، أو حدث خطأ محدد يشير إلى سبب إخفاق الإغلاق. وسيؤدي إرجاع الحالة غير الناجحة إلى إلغاء عملية الإيقاف.
|