nl::Weave::Profiles::BDX_Development

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

Artinya, jika terjadi kesalahan dalam pengendali lain yang tanda tangannya memiliki jenis nilai yang ditampilkan 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 jika mereka harus memanggil Shutdown(). Perhatikan bahwa error mungkin saja terjadi sebelum BDXTransfer diinisialisasi (misalnya sudah terlalu banyak objek transfer yang dialokasikan). Dalam kasus seperti itu, error tersebut akan dicatat dalam log oleh Weave dan protokol akan menangani pembersihan status yang diperlukan 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) HARUS menggunakan buffer yang disediakan, tetapi untuk alasan kompatibilitas mundur, dapat menampilkan buffer-nya sendiri. Tujuan panggilan tidak boleh memberikan lebih dari aLength byte. Saat ditampilkan, aLength berisi jumlah byte sebenarnya yang dibaca ke buffer.

Menangani blok data yang ditunjuk oleh aDataBlock dengan panjang Length.

Kemungkinan besar ini akan melibatkan penulisannya ke file dan menutup file tersebut jika isLastBlock adalah benar.

Callback dipanggil jika ReceiveInit yang dikirim sebelumnya diterima oleh tujuan.

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

Callback dipanggil saat menerima pesan ReceiveInit.

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

Dipanggil jika salah satu pesan Init sebelumnya ditolak oleh tujuan.

Callback dipanggil jika SendInit yang dikirim sebelumnya diterima oleh tujuan.

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

Callback dipanggil saat menerima pesan SendInit.

Tugasnya adalah menentukan apakah Anda ingin menerima SendInit dan, jika ya, setel 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 (membuka handle file, dll.) ke aXfer->mAppState. Anda juga harus menambahkan pengendali yang diperlukan, misalnya, penanganan blok ke objek BDXTransfer pada tahap ini. Jika kode error selain WEAVE_NO_ERROR yang ditampilkan, transfer dianggap ditolak dan protokol akan menangani pengiriman pesan penolakan dengan kode tersebut.

Tangani kasus saat transfer selesai.

Menangani pesan TransferError yang diterima atau dikirim oleh BDX.

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

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