nl::Tenun::Profil::BDX_Development

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

Artinya, jika terjadi error 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 melanjutkan atau jika mereka harus memanggil Shutdown(). Perhatikan bahwa mungkin terjadi error sebelum BDXTransfer diinisialisasi (misalnya sudah terlalu banyak objek yang dialokasikan Dalam kasus tersebut, error yang dicatat akan dicatat oleh Weave dan protokol akan menangani pembersihan setiap status yang diperlukan yang dialokasikan.

Get a block of data to be transmitted.

Pemanggil memberikan ruang buffering (buffering dan panjang buffer, yang diteruskan melalui referensi). Callee (aplikasi pengguna) SEBAIKNYA menggunakan buffer yang disediakan, tetapi karena alasan kompatibilitas mundur, mungkin menampilkan buffer-nya sendiri. Callee tidak boleh memberikan lebih dari aLength byte. Saat ditampilkan, aLength berisi jumlah byte sebenarnya yang dibaca ke buffer.

Tangani blok data yang ditunjuk oleh aDataBlock dengan panjang aLength.

Kemungkinan ini akan melibatkan penulisan ke file dan penutupan file tersebut jika isLastBlock adalah true.

Callback dipanggil saat ReceiveInit yang dikirim sebelumnya diterima oleh tujuan.

Anda dapat menggunakan kesempatan ini untuk membuka file atau mengalokasikan resource untuk transfer jika tidak melakukannya saat memulai.

Callback dipanggil saat menerima pesan ReceiveInit.

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

Dipanggil jika salah satu pesan Init sebelumnya ditolak oleh tujuan.

Callback dipanggil saat SendInit yang dikirim sebelumnya diterima oleh tujuan.

Anda dapat menggunakan kesempatan ini untuk membuka file atau mengalokasikan resource untuk transfer jika tidak melakukannya saat memulai.

Callback dipanggil saat menerima pesan SendInit.

Tugasnya adalah menentukan apakah Anda ingin menerima SendInit dan, jika demikian, tetapkan aXfer->mIsReceived=true sehingga protokol akan mengirim pesan terima ke inisiator. Objek BDXTransfer dimulai ke setelan default. Ini adalah tempat yang bagus untuk melampirkan status khusus aplikasi (handle file terbuka, dll.) ke aXfer->mAppState. Anda juga harus menambahkan pengendali yang diperlukan untuk, misalnya, penanganan pemblokiran ke objek BDXTransfer pada tahap ini. Jika kode error selain WEAVE_NO_ERROR ditampilkan, transfer diasumsikan 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 dapat dipulihkan (mungkin sementara, misalnya, dari PacketBuffers saat ini), jadi opsi untuk memanggil Shutdown() diserahkan kepada programmer aplikasi dan callback yang ditetapkan. PERLU DILAKUKAN: verifikasikan 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 bursa (tidak ada ack permintaan untuk TCP), dan berdasarkan dukungan waktu kompilasi untuk WRMP.