# WBT_GetBlockInfo

## C Specification

  `#include <nitro/wbt.h>`
  `BOOL WBT_GetBlockInfo(u16 target, int index, WBTBlockInfoTable *block_info_table, WBTCallback callback);`

## Arguments

target | The target AID bitmap that receives block information. This target can specify multiple parents or children at the same time.
index | The index from the top of the list of blocks that receive information in the registered block list. The block list is added to the end when newly registering with the `WBT_RegisterBlock` function, and the index is out of alignment with the list after the block is released with the `WBT_UnregisterBlock` function.
block_info_table | A pointer to the `WBTBlockInfoTable` table containing the destination address of the block information to receive. You must set a valid storage address for all AIDs specified with the target in this table.
callback | `WBTCallback` format function that receives notifications when commands are completed. This callback is called from within the `WBT_MpParentRecvHook` or WBT_MpChildRecvHook functions.

## Return Values

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

## Description

Receives the block data from the specified target device. You can get the block ID and data size from the received `WBTBlockInfo` structure data.
The call fails if a command is still processing.

## See Also

`WBT_RequestSync, WBT_GetBlock, WBT_PutUserData`

## Revision History

06/01/2005 Added text indicating that the callback is called from the WBT_MpParentRecvHook or WBT_MpChildRecvHook functions
09/21/2004 Initial version