1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<title>WBT_GetBlockInfo</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">WBT_GetBlockInfo <img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <nitro/wbt.h></CODE><BR> <BR> <CODE>BOOL WBT_GetBlockInfo(u16 target, int index, <A href="../wbt_block_info_table_type.html">WBTBlockInfoTable</A> *block_info_table, <A href="../wbt_callback_type.html">WBTCallback</A> callback);</CODE><br> <br> 20 </dd> 21</dl> 22<h2>Arguments</h2> 23<p> 24<TABLE border="1" width="100%"> 25 <TBODY> 26 <TR> 27<TD width="13%"><CODE>target</CODE></TD> 28<TD width="87%">Target AID bitmap that receives block information<br /> When child, only parent <code>1</code> can be specified.</TD> 29 </TR> 30 <TR> 31<TD width="13%"><CODE>index</CODE></TD> 32<TD width="87%">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 <A href="../common/WBT_RegisterBlock.html"><code>WBT_RegisterBlock</code></A> function, and the index is out of alignment with the list after the block is deallocated with the <A href="../common/WBT_UnregisterBlock.html"><code>WBT_UnregisterBlock</code></A> function.</TD> 33 </TR> 34 <TR> 35<TD width="13%"><CODE>block_info_table</CODE></TD> 36<TD width="87%">Pointer to the <A href="../wbt_block_info_table_type.html"><code>WBTBlockInfoTable</code></A> 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.</TD> 37 </TR> 38 <TR> 39<TD width="13%"><CODE>callback</CODE></TD> 40<TD width="87%"><A href="../wbt_callback_type.html"><CODE>WBTCallback</CODE></A> format function that receives notifications when commands are completed. This callback is called from within the <a href="../parent/WBT_MpParentRecvHook.html"><CODE>WBT_MpParentRecvHook</CODE></a> or <a href="../child/WBT_MpChildRecvHook.html">WBT_MpChildRecvHook</CODE></a> function. 41 </TD> 42 </TR> 43 </TBODY> 44</TABLE> 45</p> 46 47<h2>Return Values</h2> 48<p>If no command is currently processing, the function issues a command and returns <CODE>TRUE</CODE>. Otherwise, the function does nothing and returns <CODE>FALSE</CODE>.</p> 49 50<H2>Description</H2> 51<p>Receives the block data from the specified target device. You can get the block ID and data size from the received <A href="../wbt_block_info_type.html"><code>WBTBlockInfo</code></A> structure data.<br> <font color="#800000">The call fails if a command is still processing.</font><br> <br> 52</p> 53<H2>See Also</H2> 54<p> 55<A href="WBT_RequestSync.html"><CODE>WBT_RequestSync</CODE></A><BR> <A href="WBT_GetBlock.html"><CODE>WBT_GetBlock</CODE></A><BR> <A href="WBT_PutUserData.html"><CODE>WBT_PutUserData</CODE></A> 56</p> 57<H2>Revision History</H2> 58<P> 592006/03/13 Revised description of target argument<br>2005/06/01 Added text indicating that the callback is called from the <CODE>WBT_MpParentRecvHook</CODE> or <CODE>WBT_MpChildRecvHook</CODE> functions<br> 2004/09/31 Initial version<BR> 60</P> 61<hr><p>CONFIDENTIAL</p></body> 62</html> 63
