нл:: Переплетение:: Профили:: BDX_Девелопмент

Этот обработчик вызывается каждый раз, когда возникает ошибка Weave, которую нельзя напрямую вернуть с помощью кодов ошибок в поток управления, определяемый пользовательским приложением.

То есть, если ошибка возникает внутри другого обработчика, подпись которого имеет возвращаемый тип void (например, в ответ на входящее сообщение Weave или даже отправленное протоколом), этот обработчик будет вызван, чтобы пользователь мог определить, можно ли восстановить передачу. и продолжить, или им следует вызвать Shutdown(). Обратите внимание, что возможна ошибка до инициализации BDXTransfer (например, уже слишком много выделенных объектов передачи). В таком случае указанная ошибка будет зарегистрирована Weave, и протокол выполнит очистку любого необходимого состояния, которое он выделил.

Get a block of data to be transmitted.

Вызывающий объект предоставляет буферное пространство (буфер и длина буфера, передаваемые по ссылке). Вызываемому (пользовательскому приложению) СЛЕДУЕТ использовать предоставленный буфер, но по соображениям обратной совместимости он может возвращать свой собственный буфер. Вызываемый объект не должен предоставлять значение, превышающее aLength байт. По возвращении aLength содержит фактическое количество байтов, прочитанных в буфер.

Обработка блока данных, на который указывает aDataBlock длиной aLength.

Вероятно, это потребует записи его в файл и его закрытия, если isLastBlock имеет значение true.

Обратный вызов вызывается, когда ранее отправленный элемент ReceiveInit принимается пунктом назначения.

Вы можете использовать эту возможность для открытия файлов или выделения ресурсов для передачи, если вы не сделали этого при ее запуске.

Обратный вызов, вызываемый при получении сообщения ReceiveInit .

Его задача — определить, хотите ли вы принять получение, и, если да, установить aXfer->mIsAccepted=true, чтобы протокол отправлял сообщение о принятии инициатору. Объект BDXTransfer инициируется с настройками по умолчанию. Это хорошее место для присоединения любого состояния приложения (дескрипторы открытых файлов и т. д.) к aXfer->mAppState. На этом этапе вам также следует прикрепить необходимые обработчики, например, для обработки блоков, к объекту BDXTransfer . Если возвращается код ошибки, отличный от kStatus_Success, предполагается, что передача отклонена, и протокол обрабатывает отправку сообщения отклонения с кодом.

Вызывается, если одно из предыдущих сообщений Init было отклонено пунктом назначения.

Обратный вызов вызывается, когда ранее отправленный SendInit принимается пунктом назначения.

Вы можете использовать эту возможность для открытия файлов или выделения ресурсов для передачи, если вы не сделали этого при ее запуске.

Обратный вызов, вызываемый при получении сообщения SendInit .

Его задача — определить, хотите ли вы принять SendInit, и, если да, установить aXfer->mIsAccepted=true, чтобы протокол отправил инициатору сообщение о принятии. Объект BDXTransfer инициируется с настройками по умолчанию. Это хорошее место для присоединения любого состояния приложения (дескрипторы открытых файлов и т. д.) к aXfer->mAppState. На этом этапе вам также следует прикрепить необходимые обработчики, например, для обработки блоков, к объекту BDXTransfer . Если возвращается код ошибки, отличный от WEAVE_NO_ERROR, предполагается, что передача отклонена, и протокол обрабатывает отправку сообщения отклонения с кодом.

Обработка случаев, когда передача завершена.

Обработка сообщений TransferError , полученных или отправленных BDX.

Примечание. Предполагается, что передача BDX потенциально может быть восстановлена ​​(возможно, временно, например, из PacketBuffers в данный момент), поэтому возможность вызова Shutdown() остается на усмотрение программиста приложения и обратных вызовов, которые они определяют. TODO: проверьте это и согласуйте с формулировками в документе BDX, в которых говорится: «[Ошибка передачи] может быть отправлена ​​в любое время любой стороной для преждевременного завершения массовой передачи данных».

GetBDXAckFlag возвращает соответствующий флаг для поля RequestAck в зависимости от соединения контекста обмена (без подтверждения запроса для TCP) и на основе поддержки времени компиляции для WRMP.