nl :: Tejido:: Perfiles: BDX_Development

Este controlador se llama cada vez que se encuentra un error de Weave que no se puede devolver directamente a través de códigos de error al flujo de control definido por la aplicación del usuario.

Es decir, si ocurre un error dentro de otro controlador cuya firma tiene el tipo de retorno nulo (por ejemplo, en respuesta a un mensaje Weave entrante 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 deben llamar a Shutdown (). Tenga en cuenta que es posible que se produzca un error antes de que se inicialice una BDXTransfer (por ejemplo, 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.

La persona que llama proporciona el espacio de almacenamiento en búfer (búfer y longitud del búfer, pasados ​​por referencia). Callee (aplicación de usuario) DEBE usar el búfer provisto, pero por razones de compatibilidad con versiones anteriores, puede devolver su propio búfer. El destinatario no debe proporcionar más de una aLength de bytes. A la vuelta, aLength contiene el número real de bytes leídos en el búfer.

Maneja el bloque de datos apuntado por un DataBlock de longitud aLength.

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

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

Es posible que desee aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hizo al iniciarla.

Devolución de llamada invocada al recibir un mensaje ReceiveInit .

Su trabajo es determinar si desea aceptar la recepción y, de ser así, establecer 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 (identificadores de archivos abiertos, etc.) a aXfer-> mAppState. También debe adjuntar los controladores necesarios para, por ejemplo, el manejo de bloques al objeto BDXTransfer en este punto. Si se devuelve un código de error que no sea kStatus_Success, se supone que la transferencia es rechazada y el protocolo manejará el envío de un mensaje de rechazo con el código.

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

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

Es posible que desee aprovechar esta oportunidad para abrir archivos o asignar recursos para la transferencia si no lo hizo al iniciarla.

Devolución de llamada invocada al recibir un mensaje SendInit .

Su trabajo es determinar si desea aceptar SendInit y, de ser así, establecer 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 (identificadores de archivos abiertos, etc.) a aXfer-> mAppState. También debe adjuntar los controladores necesarios para, por ejemplo, el manejo de bloques al objeto BDXTransfer en este punto. Si se devuelve un código de error que no sea WEAVE_NO_ERROR, se asume que la transferencia es rechazada y el protocolo manejará el envío de un mensaje de rechazo con el código.

Manejar los casos donde la transferencia está terminada.

Manejar los mensajes TransferError recibidos o enviados por BDX.

Nota: Se presume que la transferencia de BDX es potencialmente recuperable (posiblemente temporal, por ejemplo, fuera de PacketBuffers en este momento) y, por lo tanto, la opción de llamar a Shutdown () se deja al programador de la aplicación y las devoluciones de llamada que definen. TODO: verificar esto y conciliarlo con el idioma en el documento BDX, que dice: "[Un TransferError] Puede ser enviado en cualquier momento por cualquiera de las partes para finalizar prematuramente la transferencia masiva de datos".

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