nl::Weave::Profiles::BDX_Development

Trình xử lý này được gọi mỗi khi gặp lỗi Weave mà không thể trả về trực tiếp thông qua mã lỗi cho luồng điều khiển do ứng dụng do người dùng xác định.

Nghĩa là, nếu xảy ra lỗi trong một trình xử lý khác có chữ ký không có loại trả về (ví dụ: để phản hồi một thông báo Weave đến hoặc thậm chí được gửi đi bởi giao thức), trình xử lý này sẽ được gọi để người dùng có thể xác định xem liệu quá trình truyền có thể được khôi phục và tiếp tục hay không hoặc nếu họ nên gọi Shutdown(). Lưu ý rằng có thể xảy ra lỗi trước khi khởi tạo BDXTransfer (ví dụ: đã có quá nhiều đối tượng truyền được phân bổ). Trong trường hợp như vậy, lỗi đã nêu sẽ được Weave ghi lại và giao thức sẽ xử lý việc xoá mọi trạng thái cần thiết mà giao thức đã phân bổ.

Get a block of data to be transmitted.

Phương thức gọi cung cấp không gian lưu vào bộ đệm (vùng đệm và độ dài của vùng đệm, được truyền vào bằng tham chiếu). Hàm được gọi (ứng dụng người dùng) PHẢI dùng vùng đệm được cung cấp. Tuy nhiên, vì lý do tương thích ngược, có thể trả về vùng đệm của riêng nó. Hàm được gọi không được cung cấp nhiều hơn aLength byte. Khi trả về, aLength chứa số byte thực tế được đọc vào vùng đệm.

Xử lý khối dữ liệu được trỏ đến bởi aDataBlock có độ dài aLength.

Có thể điều này sẽ liên quan đến việc ghi nó vào một tệp và đóng tệp đã nêu nếu isLastBlock là true.

Lệnh gọi lại được gọi khi đích đến chấp nhận ReceiveInit đã gửi trước đó.

Bạn nên tận dụng cơ hội này để mở tệp hoặc phân bổ tài nguyên cho quá trình chuyển nếu chưa thực hiện việc này khi bắt đầu.

Lệnh gọi lại được gọi khi nhận được thông báo ReceiveInit.

Nhiệm vụ của chương trình là xác định xem bạn có muốn chấp nhận receiver hay không. Nếu có, hãy thiết lập aXfer->mIs accepted=true để giao thức gửi thông báo chấp nhận đến trình khởi tạo. Đối tượng BDXTransfer được khởi tạo theo chế độ cài đặt mặc định. Đây là nơi phù hợp để đính kèm mọi trạng thái dành riêng cho ứng dụng (mở tệp điều khiển, v.v.) vào aXfer->mAppState. Tại thời điểm này, bạn cũng nên đính kèm các trình xử lý cần thiết, ví dụ: xử lý khối vào đối tượng BDXTransfer. Nếu mã lỗi không phải là kStatus_Success được trả về, quá trình chuyển được coi là bị từ chối và giao thức sẽ xử lý việc gửi thông báo từ chối kèm theo mã.

Được gọi nếu một trong các thông báo Init trước đó bị đích đến từ chối.

Lệnh gọi lại được gọi khi đích đến chấp nhận SendInit đã gửi trước đó.

Bạn nên tận dụng cơ hội này để mở tệp hoặc phân bổ tài nguyên cho quá trình chuyển nếu chưa thực hiện việc này khi bắt đầu.

Lệnh gọi lại được gọi khi nhận được thông báo SendInit.

Nhiệm vụ của chương trình là xác định xem bạn có muốn chấp nhận SendInit hay không và nếu có, hãy thiết lập aXfer->mIsRequired=true để giao thức gửi thông báo chấp nhận đến trình khởi tạo. Đối tượng BDXTransfer được khởi tạo theo chế độ cài đặt mặc định. Đây là nơi phù hợp để đính kèm mọi trạng thái dành riêng cho ứng dụng (mở tệp điều khiển, v.v.) vào aXfer->mAppState. Tại thời điểm này, bạn cũng nên đính kèm các trình xử lý cần thiết, ví dụ: xử lý khối vào đối tượng BDXTransfer. Nếu một mã lỗi khác WEAVE_NO_ERROR được trả về, quá trình chuyển được coi là bị từ chối và giao thức sẽ xử lý việc gửi thông báo từ chối kèm theo mã này.

Xử lý các trường hợp đã chuyển xong.

Xử lý thông báo TransferError do BDX nhận hoặc gửi.

Lưu ý: Quá trình chuyển BDX được cho là có khả năng khôi phục (có thể là tạm thời, chẳng hạn như hết Gói đệm vào lúc này), do đó tuỳ chọn gọi Shutdown() được để lại cho lập trình viên ứng dụng và các lệnh gọi lại mà họ xác định. VIỆC CẦN LÀM: xác minh thông tin này và điều chỉnh lại với ngôn ngữ trong tài liệu BDX, trong đó có nêu rõ: "[A TransferError] Có thể được một trong hai bên gửi bất cứ lúc nào để kết thúc sớm hoạt động chuyển dữ liệu hàng loạt".

GetBDXAckFlag trả về cờ thích hợp cho trường RequestAck tuỳ thuộc vào kết nối của ngữ cảnh trao đổi (không xác định yêu cầu đối với TCP) và dựa trên khả năng hỗ trợ thời gian biên dịch của WRMP.