WBT_GetBlockInfo

Syntax

#include <nitro/wbt.h>

BOOL WBT_GetBlockInfo(u16 target, int index, WBTBlockInfoTable *block_info_table, WBTCallback callback);

Arguments

target Target AID bitmap that receives block information
When child, only parent 1 can be specified.

index 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 deallocated with the WBT_UnregisterBlock function.

block_info_table 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 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 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.

Revision History

2006/03/13 Revised description of target argument
2005/06/01 Added text indicating that the callback is called from the WBT_MpParentRecvHook or WBT_MpChildRecvHook functions
2004/09/31 Initial version

CONFIDENTIAL