Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

UDP

تتضمن هذه الوحدة الوظائف التي تتحكم في اتصالات UDP.

ملخص

النوع

otUdpHandler )(void *aContext, const otMessage *aMessage, const otMessageInfo *aMessageInfo) typedef
bool(*
يسمح رد الاتصال هذا لـ OpenThread بتوفير معالجات محددة لبعض رسائل UDP.
otUdpReceive )(void *aContext, otMessage *aMessage, const otMessageInfo *aMessageInfo) typedef
void(*
يسمح رد الاتصال هذا لـ OpenThread بإبلاغ التطبيق برسالة UDP مستلمة.
otUdpReceiver typedef
تمثل هذه البنية مستقبل UDP.
otUdpSocket typedef
struct otUdpSocket
يمثل هذا الهيكل مقبس UDP.

المهام

otUdpAddReceiver ( otInstance *aInstance, otUdpReceiver *aUdpReceiver)
تضيف هذه الوظيفة مستقبل UDP.
otUdpBind ( otInstance *aInstance, otUdpSocket *aSocket, const otSockAddr *aSockName)
اربط مقبس UDP / IPv6.
otUdpClose ( otInstance *aInstance, otUdpSocket *aSocket)
أغلق مقبس UDP / IPv6.
otUdpConnect ( otInstance *aInstance, otUdpSocket *aSocket, const otSockAddr *aSockName)
قم بتوصيل مقبس UDP / IPv6.
otUdpGetSockets ( otInstance *aInstance)
تحصل هذه الوظيفة على رأس القائمة المرتبطة بمقابس UDP.
otUdpNewMessage ( otInstance *aInstance, const otMessageSettings *aSettings)
قم بتخصيص مخزن مؤقت للرسائل الجديدة لإرسال رسالة UDP.
otUdpOpen ( otInstance *aInstance, otUdpSocket *aSocket, otUdpReceive aCallback, void *aContext)
افتح مقبس UDP / IPv6.
otUdpRemoveReceiver ( otInstance *aInstance, otUdpReceiver *aUdpReceiver)
تزيل هذه الوظيفة جهاز استقبال UDP.
otUdpSend ( otInstance *aInstance, otUdpSocket *aSocket, otMessage *aMessage, const otMessageInfo *aMessageInfo)
أرسل رسالة UDP / IPv6.
otUdpSendDatagram ( otInstance *aInstance, otMessage *aMessage, otMessageInfo *aMessageInfo)
ترسل هذه الوظيفة رسالة UDP بدون مأخذ توصيل.

الهياكل

otUdpR Receiver

تمثل هذه البنية مستقبل UDP.

otUdpSocket

يمثل هذا الهيكل مقبس UDP.

النوع

otUdpHandler

bool(* otUdpHandler)(void *aContext, const otMessage *aMessage, const otMessageInfo *aMessageInfo)

يسمح رد الاتصال هذا لـ OpenThread بتوفير معالجات محددة لبعض رسائل UDP.

تفاصيل
إرجاع القيم
true
يتم التعامل مع الرسالة بواسطة جهاز الاستقبال هذا ويجب ألا تتم معالجتها مرة أخرى.
false
لا يتم معالجة الرسالة بواسطة هذا المتلقي.

otUdpReceive

void(* otUdpReceive)(void *aContext, otMessage *aMessage, const otMessageInfo *aMessageInfo)

يسمح رد الاتصال هذا لـ OpenThread بإبلاغ التطبيق برسالة UDP مستلمة.

otUdpR Receiver

struct otUdpReceiver otUdpReceiver

تمثل هذه البنية مستقبل UDP.

otUdpSocket

struct otUdpSocket otUdpSocket

يمثل هذا الهيكل مقبس UDP.

المهام

otUdpAddReceiver

otError otUdpAddReceiver(
  otInstance *aInstance,
  otUdpReceiver *aUdpReceiver
)

تضيف هذه الوظيفة مستقبل UDP.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aUdpReceiver
مؤشر لجهاز استقبال UDP.
إرجاع القيم
OT_ERROR_NONE
تمت إضافة المتلقي بنجاح.
OT_ERROR_ALREADY
تمت إضافة جهاز استقبال UDP بالفعل.

otUdpBind

otError otUdpBind(
  otInstance *aInstance,
  otUdpSocket *aSocket,
  const otSockAddr *aSockName
)

اربط مقبس UDP / IPv6.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSocket
مؤشر إلى بنية مقبس UDP.
[in] aSockName
مؤشر إلى بنية عنوان مأخذ توصيل IPv6.
إرجاع القيم
OT_ERROR_NONE
كانت عملية الربط ناجحة.
OT_ERROR_FAILED
فشل ربط مأخذ توصيل UDP.

otUdp إغلاق

otError otUdpClose(
  otInstance *aInstance,
  otUdpSocket *aSocket
)

أغلق مقبس UDP / IPv6.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSocket
مؤشر إلى بنية مقبس UDP.
إرجاع القيم
OT_ERROR_NONE
أغلق المقبس بنجاح.
OT_ERROR_FAILED
فشل إغلاق مأخذ توصيل UDP.

otUdpConnect

otError otUdpConnect(
  otInstance *aInstance,
  otUdpSocket *aSocket,
  const otSockAddr *aSockName
)

قم بتوصيل مقبس UDP / IPv6.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSocket
مؤشر إلى بنية مقبس UDP.
[in] aSockName
مؤشر إلى بنية عنوان مأخذ توصيل IPv6.
إرجاع القيم
OT_ERROR_NONE
كانت عملية الاتصال ناجحة.
OT_ERROR_FAILED
فشل توصيل مقبس UDP.

otUdpGetSockets

otUdpSocket * otUdpGetSockets(
  otInstance *aInstance
)

تحصل هذه الوظيفة على رأس القائمة المرتبطة بمقابس UDP.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
مؤشر إلى رأس قائمة UDP Socket المرتبطة.

otUdpNewMessage

otMessage * otUdpNewMessage(
  otInstance *aInstance,
  const otMessageSettings *aSettings
)

قم بتخصيص مخزن رسائل جديد لإرسال رسالة UDP.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSettings
مؤشر إلى إعدادات الرسالة أو NULL لاستخدام الإعدادات الافتراضية.
عائدات
مؤشر إلى المخزن المؤقت للرسالة أو NULL إذا لم تتوفر مخازن رسائل مؤقتة أو كانت المعلمات غير صالحة.
أنظر أيضا:
otMessageFree

otUdpOpen

otError otUdpOpen(
  otInstance *aInstance,
  otUdpSocket *aSocket,
  otUdpReceive aCallback,
  void *aContext
)

افتح مقبس UDP / IPv6.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSocket
مؤشر إلى بنية مقبس UDP.
[in] aCallback
مؤشر إلى وظيفة رد الاتصال للتطبيق.
[in] aContext
مؤشر إلى سياق خاص بالتطبيق.
إرجاع القيم
OT_ERROR_NONE
تم فتح المقبس بنجاح.
OT_ERROR_FAILED
فشل في فتح المقبس.

otUdpRemoveReceiver

otError otUdpRemoveReceiver(
  otInstance *aInstance,
  otUdpReceiver *aUdpReceiver
)

تزيل هذه الوظيفة جهاز استقبال UDP.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aUdpReceiver
مؤشر لجهاز استقبال UDP.
إرجاع القيم
OT_ERROR_NONE
تمت إزالة المتلقي بنجاح.
OT_ERROR_NOT_FOUND
لم تتم إضافة جهاز استقبال UDP.

otUdpSend

otError otUdpSend(
  otInstance *aInstance,
  otUdpSocket *aSocket,
  otMessage *aMessage,
  const otMessageInfo *aMessageInfo
)

أرسل رسالة UDP / IPv6.

إذا كانت قيمة الإرجاع هي OT_ERROR_NONE ، فإن OpenThread يأخذ ملكية aMessage ، ويجب ألا يشير المتصل إلى aMessage . إذا لم تكن قيمة الإرجاع OT_ERROR_NONE ، يحتفظ المتصل بملكية aMessage ، بما في ذلك تحرير aMessage إذا لم تعد هناك حاجة إلى المخزن المؤقت للرسائل.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSocket
مؤشر إلى بنية مقبس UDP.
[in] aMessage
مؤشر إلى مخزن الرسائل المؤقت.
[in] aMessageInfo
مؤشر إلى بنية معلومات الرسالة.

تفاصيل
إرجاع القيم
OT_ERROR_NONE
تمت جدولة الرسالة للإرسال بنجاح.
OT_ERROR_INVALID_ARGS
تم إعطاء وسيطات غير صالحة.
OT_ERROR_NO_BUFS
المخزن المؤقت المتاح غير كافٍ لإضافة رؤوس UDP و IPv6.

otUdpSendDatagram

0505 ب19240

ترسل هذه الوظيفة رسالة UDP بدون مأخذ توصيل.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aMessage
مؤشر لرسالة بدون رأس UDP.
[in] aMessageInfo
مؤشر إلى معلومات الرسالة المرتبطة بـ aMessage .
إرجاع القيم
OT_ERROR_NONE
تم بنجاح وضع الرسالة في قائمة الانتظار في واجهة الإخراج.
OT_ERROR_NO_BUFS
المخزن المؤقت المتاح غير كافٍ لإضافة رؤوس IPv6.