nl::Weave::Profiles::BDX_Development

Pengendali ini dipanggil setiap kali terjadi error Weave yang tidak bisa langsung dikembalikan melalui kode error ke alur kontrol yang ditentukan aplikasi pengguna.

Artinya, jika terjadi error dalam pengendali lain yang tanda tangannya memiliki jenis pengembalian void (misalnya sebagai respons terhadap pesan Weave yang masuk atau bahkan dikirim oleh protokol), pengendali ini akan dipanggil sehingga pengguna dapat menentukan apakah transfer dapat dipulihkan dan dilanjutkan, atau apakah mereka harus memanggil Shutdown(). Perhatikan bahwa error mungkin terjadi sebelum BDXTransfer dilakukan sebelum transfer BDXTransfer sudah terlalu banyak diinisialisasi. Dalam kasus seperti itu, error tersebut akan dicatat oleh Weave dan protokol akan menangani pembersihan status penting yang dialokasikan.

Get a block of data to be transmitted.

Pemanggil menyediakan ruang buffering (buffer dan panjang buffer, yang diteruskan melalui referensi). Callee (aplikasi pengguna) SEHARUS menggunakan buffer yang disediakan, tetapi untuk alasan kompatibilitas mundur, dapat mengembalikan buffer-nya sendiri. Penerima panggilan tidak boleh menyediakan lebih dari aLength byte. Saat ditampilkan, aLength berisi jumlah byte sebenarnya yang dibaca ke dalam buffer.

Menangani blok data yang ditunjuk oleh aDataBlock dengan panjang aLength.

Kemungkinan tindakan ini akan melibatkan penulisan ke file dan menutup file tersebut jika isLastBlock bernilai true.

Callback yang dipanggil saat ReceiveInit yang dikirim sebelumnya diterima oleh tujuan.

Anda dapat menggunakan kesempatan ini untuk membuka file atau mengalokasikan sumber daya untuk transfer jika Anda tidak melakukannya saat memulainya.

Callback dipanggil saat menerima pesan ReceiveInit.

Tugasnya adalah menentukan apakah Anda ingin menerima Accept dan, jika demikian, menyetel aXfer->mIsAccepted=true sehingga protokol akan mengirimkan pesan terima ke inisiator. Objek BDXTransfer dimulai ke setelan default. Ini adalah tempat yang baik untuk melampirkan status khusus aplikasi (handle file terbuka, dll.) ke aXfer->mAppState. Anda juga harus menambahkan pengendali yang diperlukan untuk, misalnya, penanganan blok ke objek BDXTransfer pada tahap ini. Jika kode error selain kStatus_Success ditampilkan, transfer dianggap ditolak dan protokol akan menangani pengiriman pesan penolakan dengan kode tersebut.

Dipanggil jika salah satu pesan Init sebelumnya ditolak oleh tujuan.

Callback yang dipanggil saat SendInit yang dikirim sebelumnya diterima oleh tujuan.

Anda dapat menggunakan kesempatan ini untuk membuka file atau mengalokasikan sumber daya untuk transfer jika Anda tidak melakukannya saat memulainya.

Callback dipanggil saat menerima pesan SendInit.

Tugasnya adalah menentukan apakah Anda ingin menerima SendInit dan, jika ya, menyetel aXfer->mIsAccepted=true sehingga protokol akan mengirimkan pesan terima ke inisiator. Objek BDXTransfer dimulai ke setelan default. Ini adalah tempat yang baik untuk melampirkan status khusus aplikasi (handle file terbuka, dll.) ke aXfer->mAppState. Anda juga harus menambahkan pengendali yang diperlukan untuk, misalnya, penanganan blok ke objek BDXTransfer pada tahap ini. Jika kode error selain WEAVE_NO_ERROR ditampilkan, transfer dianggap ditolak dan protokol akan menangani pengiriman pesan penolakan dengan kode tersebut.

Menangani kasus saat transfer selesai.

Menangani pesan TransferError yang diterima atau dikirim oleh BDX.

Catatan:Transfer BDX dianggap berpotensi dapat dipulihkan (mungkin untuk sementara, misalnya di luar PacketBuffers saat ini) sehingga opsi untuk memanggil Shutdown() diserahkan kepada programmer aplikasi dan callback yang ditentukan. TODO: verifikasi dan rekonsiliasi dengan bahasa dalam dokumen BDX, yang menyatakan: "[A TransferError] Dapat dikirim kapan saja oleh salah satu pihak untuk mengakhiri transfer data massal sebelum waktunya."

GetBDXAckFlag menampilkan flag yang sesuai untuk kolom RequestAck, bergantung pada koneksi konteks pertukaran (tidak ada ack permintaan untuk TCP), dan berdasarkan dukungan waktu kompilasi untuk WRMP.