WBT_GetBlock 

Syntax

#include <nitro/wbt.h>

BOOL WBT_GetBlock(u16 target, u32 block_id, WBTRecvBufTable *recv_buf_table, u32 recv_size, WBTPacketBitmapTable *p_bmp_table, WBTCallback callback);

Arguments

target Target AID bitmap that receives block data.
When child, only parent 1 can be specified.
block_id Block ID of the data to receive. The specified block ID must be recorded with the WBT_RegisterBlock function on the object side.
recv_buf_table Pointer to the WBTRecvBufTable table containing the storage address (receive archive record) of the data to receive. You must set a valid storage address for all AIDs specified with the target in this table.
recv_size Receive size of the data.
p_bmp_table A pointer to the WBTPacketBitmapTable table containing the bitmap buffer to manage the progress of the data to receive. You must set a valid bitmap buffer for all AIDs specified with the target in this table. Any AID not specified by target can be NULL.
callback WBTCallback format function that receives notifications when commands are completed. This callback is called from within the WBT_MpParentRecvHook or WBT_MpChildRecvHook function.

Return Values

If no command is currently processing, the function issues a command and returns TRUE. Otherwise, the function does nothing and returns FALSE.

Description

Receives block data from a specified target device.
The call fails if a command is still processing.

See Also

WBT_RequestSync
WBT_GetBlockInfo
WBT_PutUserData

Revision History

2006/03/13 Revised description of target argument.
2005/06/01 Added statement about the callback being called from the WBT_MpParentRecvHook or WBT_MpChildRecvHook function.
2005/02/18 Changed description of packet_bitmap to "bitmap buffer for receive history record."
2004/09/21 Initial version.


CONFIDENTIAL