Google is committed to advancing racial equity for Black communities. See how.

UDP

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

ملخص

التعداد

otNetifIdentifier {
OT_NETIF_UNSPECIFIED = 0,
OT_NETIF_THREAD ,
OT_NETIF_BACKBONE
}
تعداد
يحدد هذا التعداد معرفات واجهة شبكة OpenThread.

النوع

otNetifIdentifier typedef
يحدد هذا التعداد معرفات واجهة شبكة OpenThread.
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, otNetifIdentifier aNetif)
اربط مقبس UDP / IPv6.
otUdpClose ( otInstance *aInstance, otUdpSocket *aSocket)
أغلق مقبس UDP / IPv6.
otUdpConnect ( otInstance *aInstance, otUdpSocket *aSocket, const otSockAddr *aSockName)
قم بتوصيل مقبس UDP / IPv6.
otUdpGetSockets ( otInstance *aInstance)
تحصل هذه الوظيفة على رأس القائمة المرتبطة بمقابس UDP.
otUdpIsOpen ( otInstance *aInstance, const otUdpSocket *aSocket)
bool
تحقق مما إذا كان مقبس 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.

التعداد

otNetifIdentifier

 otNetifIdentifier

يحدد هذا التعداد معرفات واجهة شبكة OpenThread.

الخصائص
OT_NETIF_BACKBONE

واجهة العمود الفقري.

OT_NETIF_THREAD

واجهة الموضوع.

OT_NETIF_UNSPECIFIED

واجهة شبكة غير محددة.

النوع

otNetifIdentifier

enum otNetifIdentifier otNetifIdentifier

يحدد هذا التعداد معرفات واجهة شبكة OpenThread.

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,
  otNetifIdentifier aNetif
)

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSocket
مؤشر إلى بنية مقبس UDP.
[in] aSockName
مؤشر إلى بنية عنوان مأخذ توصيل IPv6.
[in] aNetif
واجهة الشبكة المراد ربطها.
إرجاع القيم
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 المرتبطة.

otUdpIsOpen

bool otUdpIsOpen(
  otInstance *aInstance,
  const otUdpSocket *aSocket
)

تحقق مما إذا كان مقبس UDP مفتوحًا.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSocket
مؤشر إلى بنية مقبس UDP.
عائدات
ما إذا كان مقبس UDP مفتوحًا أم لا.

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.

otUdp إرسال

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

otError otUdpSendDatagram(
  otInstance *aInstance,
  otMessage *aMessage,
  otMessageInfo *aMessageInfo
)

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

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