nl::Weave::Profiles::BDX_Development

このハンドラは、ユーザー アプリケーション定義の制御フローにエラーコードを介して直接返せない Weave エラーが発生すると、いつでも呼び出されます。

つまり、シグネチャの戻り値の型が void である別のハンドラ内でエラーが発生した場合（受信 Weave メッセージへの応答や、プロトコルによるディスパッチなど）、このハンドラが呼び出され、ユーザーは転送を復元して続行できるかどうか、または Shutdown() を呼び出す必要があるかどうかを判断できます。BDXTransfer が初期化される前にエラーが発生する可能性があります（転送オブジェクトが多すぎるなど）。このような場合、前出のエラーは Weave によって記録され、プロトコルが割り当てた必要な状態のクリーンアップを処理します。

Get a block of data to be transmitted.

呼び出し元は、バッファリング空間（参照によって渡されたバッファとその長さ）を提供します。呼び出し先（ユーザーアプリ）は提供されたバッファを使用すべきですが、下位互換性の理由から独自のバッファを返す場合があります。呼び出し先は aLength を超えるバイト値を指定できません。返される aLength には、バッファに読み取られた実際のバイト数が含まれます。

長さが aLength の aDataBlock で示されるデータブロックを処理します。

多くの場合、これをファイルに書き込んで、isLastBlock が true であればそのファイルを閉じます。

以前に送信された ReceiveInit が宛先で受け入れられたときに呼び出されるコールバック。

転送の開始時にしなかった場合は、この機会を利用してファイルを開くか、リソースを割り当てることをおすすめします。

ReceiveInit メッセージを受信したときに呼び出されるコールバック。

その役割は、受信を受け入れるかどうかを決定することです。受け入れる場合は、aXfer->mIsAccepted=true を設定して、プロトコルがイニシエータに承認メッセージを送信します。BDXTransfer オブジェクトがデフォルト設定で開始されます。これは、アプリ固有の状態（オープン ファイル ハンドルなど）を aXfer->mAppState にアタッチするのに適しています。また、この時点で、ブロック処理などに必要なハンドラを BDXTransfer オブジェクトにアタッチする必要があります。kStatus_Success 以外のエラーコードが返された場合、転送は拒否されたとみなされ、プロトコルがそのコードを含む拒否メッセージの送信を処理します。

前の Init メッセージの 1 つが宛先によって拒否された場合に呼び出されます。

以前に送信された SendInit が宛先で受け入れられたときに呼び出されるコールバック。

転送の開始時にしなかった場合は、この機会を利用してファイルを開くか、リソースを割り当てることをおすすめします。

SendInit メッセージを受信したときに呼び出されるコールバック。

その役割は、SendInit を受け入れるかどうかを判別し、受け入れる場合は aXfer->mIsAccepted=true に設定して、プロトコルがイニシエータに承認メッセージを送信するようにすることです。BDXTransfer オブジェクトがデフォルト設定で開始されます。これは、アプリ固有の状態（オープン ファイル ハンドルなど）を aXfer->mAppState にアタッチするのに適しています。また、この時点で、ブロック処理などに必要なハンドラを BDXTransfer オブジェクトにアタッチする必要があります。WEAVE_NO_ERROR 以外のエラーコードが返された場合、転送は拒否されたとみなされ、プロトコルはそのコードを含む拒否メッセージの送信を処理します。

転送が完了したケースに対応する。

BDX によって送受信された TransferError メッセージを処理します。

注: BDX 転送は回復可能であると考えられるため（その時点で PacketBuffers から抜けているなど、一時的なものである可能性がある）、Shutdown() を呼び出すオプションは、アプリケーション プログラマーとそれが定義するコールバックに委ねられます。TODO: これを確認し、BDX ドキュメントの文言と「[A TransferError] Can be send an when any party to prematurely ending data transfer」という内容で調整します。

GetBDXAckFlag は、交換コンテキストの接続（TCP に対するリクエスト確認応答なし）と WRMP のコンパイル時サポートに基づいて、RequestAck フィールドに適切なフラグが返されます。