nl::Weave::Profiles::BDX_Development

Se llama a este controlador cada vez que se encuentra un error de Weave que no se puede mostrar directamente mediante códigos de error al flujo de control definido por la aplicación del usuario.

Es decir, si se produce un error dentro de otro controlador cuya firma tiene vacío de tipo de datos (p.ej., en respuesta a un mensaje entrante de Weave o incluso enviado por el protocolo), se llamará a este controlador para que el usuario pueda determinar si la transferencia se puede recuperar y continuar o si debe llamar a Shutdown(). Ten en cuenta que es posible que se produzca un error antes de que se inicialice un BDXTransfer (p.ej., ya hay demasiados objetos de transferencia asignados). En tal caso, Weave registrará dicho error y el protocolo se encargará de limpiar cualquier estado necesario que haya asignado.

Get a block of data to be transmitted.

El llamador proporciona el espacio de almacenamiento en búfer (búfer y la longitud del búfer, que se pasa por referencia). Callee (aplicación de usuario) DEBE usar el búfer proporcionado, pero, por razones de retrocompatibilidad, puede mostrar su propio búfer. Callee no debe proporcionar más de aLength de bytes. Cuando se muestra, aLength contiene la cantidad real de bytes leídos en el búfer.

Maneja el bloque de datos al que apunta un DataBlock de longitud aLength.

Es probable que esto implique escribirlo en un archivo y cerrarlo si isLastBlock es verdadero.

Es la devolución de llamada que se invoca cuando el destino acepta un ReceiveInit enviado anteriormente.

Te recomendamos aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hiciste al iniciarla.

Es la devolución de llamada que se invoca cuando se recibe un mensaje ReceiveInit.

Su trabajo es determinar si deseas aceptar la recepción y, de ser así, configurar aXfer->mIsAccepted=true para que el protocolo envíe un mensaje de aceptación al iniciador. El objeto BDXTransfer se inicia con la configuración predeterminada. Este es un buen lugar para adjuntar cualquier estado específico de la aplicación (controladores de archivos abiertos, etc.) a aXfer->mAppState. También debes adjuntar los controladores necesarios para, p.ej., control de bloques al objeto BDXTransfer en este punto. Si se muestra un código de error distinto de kStatus_Success, se supone que la transferencia es rechazada y el protocolo se encargará de enviar un mensaje de rechazo con el código.

Se invoca si el destino rechazó uno de los mensajes Init anteriores.

Es la devolución de llamada que se invoca cuando el destino acepta un SendInit enviado anteriormente.

Te recomendamos aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hiciste al iniciarla.

Es la devolución de llamada que se invoca cuando se recibe un mensaje SendInit.

Su trabajo es determinar si deseas aceptar SendInit y, de ser así, configurar aXfer->mIsAccepted=true para que el protocolo envíe un mensaje de aceptación al iniciador. El objeto BDXTransfer se inicia con la configuración predeterminada. Este es un buen lugar para adjuntar cualquier estado específico de la aplicación (controladores de archivos abiertos, etc.) a aXfer->mAppState. También debes adjuntar los controladores necesarios para, p.ej., control de bloques al objeto BDXTransfer en este punto. Si se muestra un código de error distinto de WEAVE_NO_ERROR, se supone que la transferencia es rechazada y el protocolo se encargará del envío de un mensaje de rechazo con el código.

Controla los casos en los que finaliza la transferencia.

Maneja mensajes de TransferError recibidos o enviados por BDX.

Nota: Se supone que la transferencia de BDX es potencialmente recuperable (es posible que sea temporal, p.ej., desde packageBuffers en este momento) y, por lo tanto, la opción de llamar a Shutdown() quedará en manos del programador de la aplicación y de las devoluciones de llamada que defina. TODO: verifica esto y concilialo con el lenguaje del documento de BDX, que establece lo siguiente: "[A TransferError] Puede ser enviado en cualquier momento por cualquiera de las partes para finalizar la transferencia masiva de datos".

GetBDXAckFlag muestra el indicador adecuado para el campo RequestAck según la conexión del contexto de intercambio (sin confirmación de solicitud para TCP) y según la compatibilidad con el tiempo de compilación para WRMP.