nl::Weave::Hồ sơ::BDX_Phát triển

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

Tức là, nếu một lỗi xảy ra trong một trình xử lý khác có chữ ký có hiệu lực trả về (ví dụ: để phản hồi thư Weave đến hoặc thậm chí được gửi bởi giao thức), thì trình xử lý này sẽ được gọi để người dùng có thể xác định xem quá trình chuyển có thể khôi phục được và tiếp tục hay không, hoặc liệu họ có gọi hàm Shutdown() hay không (ví dụ: có thể có nhiều đối tượng được phân bổ). Trong trường hợp như vậy, Weave sẽ ghi lại lỗi và cho biết giao thức sẽ xử lý trạng thái cần thiết mà Weave đã phân bổ.

Get a block of data to be transmitted.

Người gọi cung cấp không gian lưu vào bộ đệm (vùng đệm và độ dài của bộ đệm, được chuyển vào bằng cách tham chiếu). Callee (ứng dụng người dùng) NÊN sử dụng bộ đệm cung cấp, nhưng vì lý do tương thích ngược, có thể trả về bộ đệm riêng. Lệnh 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 vào bộ đệm.

Xử lý khối dữ liệu do aDataBlock có độ dài a a trỏ đến.

Có thể vấn đề này sẽ bao gồm việc ghi tệp vào một tệp và đóng tệp đã nói nếu isLastBlock có đúng.

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

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

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

Công việc của nó là xác định xem bạn có muốn chấp nhận Nhận hay không và nếu có thì đặt aXfer->mIsChấp== sao để giao thức sẽ gửi thông báo chấp nhận đến bộ khởi tạo. Đối tượng BDXTransfer được khởi tạo thành chế độ cài đặt mặc định. Đây là lúc thích hợp để đính kèm mọi trạng thái dành riêng cho ứng dụng (trình xử lý tệp đang mở, v.v.) vào aXfer->mAppState. Bạn cũng nên đính kèm các trình xử lý cần thiết (ví dụ: chặn xử lý đối với đối tượng BDXTransfer tại thời điểm này). Nếu mã lỗi không phải kStatus_Success được trả về, yêu cầu chuyển sẽ đượ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ị từ chối.

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

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

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

Công việc của chúng tôi là xác định xem bạn có muốn chấp nhận GửiInit hay không và nếu có, hãy đặt aXfer->mIsIs=true để giao thức sẽ gửi thông báo chấp nhận đến bộ khởi tạo. Đối tượng BDXTransfer được khởi tạo thành chế độ cài đặt mặc định. Đây là lúc thích hợp để đính kèm mọi trạng thái dành riêng cho ứng dụng (trình xử lý tệp đang mở, v.v.) vào aXfer->mAppState. Bạn cũng nên đính kèm các trình xử lý cần thiết (ví dụ: chặn xử lý đối với đối tượng BDXTransfer tại thời điểm này). Nếu mã lỗi khác với WEAVE_NO_ERROR được trả về, yêu cầu chuyển sẽ đượ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ã.

Xử lý các trường hợp khi quá trình chuyển hoàn tất.

Xử lý các thông báo TransferLỗi đã nhận được hoặc được gửi từ BDX.

Lưu ý: Quá trình chuyển BDX được cho là có thể khôi phục được (có thể là tạm thời, chẳng hạn như khỏi PacketBuffers tại thời điểm này) và do đó, tùy chọn gọi Shutdown() được để lại cho trình lập trình ứng dụng và các lệnh gọi lại mà chúng xác định. VIỆC CẦN LÀM: xác minh và đối chiếu thông tin này với ngôn ngữ trong tài liệu BDX có ghi: "[A TransferLỗi] Một trong hai bên sẽ có thể gửi sớm để kết thúc quá trình chuyển dữ liệu hàng loạt;"

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