WBT_GetBlock


C Specification

#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);

Description

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

Arguments

target The target AID bitmap that receives block data. The target can specify multiple parents or children at once.
block_id The 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 A pointer to the WBTRecvBufTable table containing the storage address of the data to receive. You must set a valid storage address for all AIDs specified with the target in this table.
recv_size The 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.
callback The WBTCallback type of function that receives notification when the command completes.

Return Values

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

See Also

WBT_RequestSync, WBT_GetBlockInfo, WBT_PutUserData

Revision History

09/21/2004 Initial version