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