# 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