1 /*---------------------------------------------------------------------------*
2   Project:  TwlSDK - cht - include
3   File:     pictocatch.h
4 
5   Copyright 2003-2008 Nintendo. All rights reserved.
6 
7   These coded instructions, statements, and computer programs contain
8   proprietary information of Nintendo of America Inc. and/or Nintendo
9   Company Ltd., and are protected by Federal copyright law. They may
10   not be disclosed to third parties or copied or duplicated in any form,
11   in whole or in part, without the prior written consent of Nintendo.
12 
13   $Date:: 2008-09-17#$
14   $Rev: 8556 $
15   $Author: okubata_ryoma $
16  *---------------------------------------------------------------------------*/
17 #ifndef TWL_CHT_ARM9_PICTOCATCH_H_
18 #define TWL_CHT_ARM9_PICTOCATCH_H_
19 
20 #ifdef  __cplusplus
21 extern "C" {
22 #endif
23 
24 /*===========================================================================*/
25 
26 #include <nitro/types.h>
27 #include <nitro/wm.h>
28 
29 
30 /*---------------------------------------------------------------------------*
31   Name:         CHT_IsPictochatParent
32 
33   Description:  Checks whether parent's beacon information indicates it is a PictoChat beacon.
34 
35 
36   Arguments:    pWmBssDesc:     Pointer to beacon information being checked.
37 
38   Returns:      BOOL - Returns TRUE for PictoChat beacons and FALSE otherwise.
39 
40  *---------------------------------------------------------------------------*/
41 BOOL    CHT_IsPictochatParent( const WMBssDesc* pWmBssDesc );
42 
43 /*---------------------------------------------------------------------------*
44   Name:         CHT_GetPictochatClientNum
45 
46   Description:  Checks the PictoChat beacon information to see how many children are participating in the group.
47 
48                 If the beacon is not a PictoChat beacon this function returns an undefined value, so before running this execute CHT_IsPictochatParent to verify it is a PictoChat beacon.
49 
50 
51   Arguments:    pWmBssDesc:     Pointer to beacon information being checked.
52 
53   Returns:      int:           The number of children participating in group.
54                                 Returns -1 if beacon information is abnormal.
55  *---------------------------------------------------------------------------*/
56 int     CHT_GetPictochatClientNum( const WMBssDesc* pWmBssDesc );
57 
58 /*---------------------------------------------------------------------------*
59   Name:         CHT_GetPictochatRoomNumber
60 
61   Description:  Gets the room number from the PictoChat beacon information.
62                 If the beacon is not a PictoChat beacon this function returns an undefined value, so before running this execute CHT_IsPictochatParent to verify it is a PictoChat beacon.
63 
64 
65   Arguments:    pWmBssDesc:     Pointer to beacon information being checked.
66 
67   Returns:      int:           Returns the room number.
68                                 Returns -1 if beacon information is abnormal.
69  *---------------------------------------------------------------------------*/
70 int     CHT_GetPictochatRoomNumber( const WMBssDesc* pWmBssDesc );
71 
72 
73 /*===========================================================================*/
74 
75 #ifdef  __cplusplus
76 }       /* extern "C" */
77 #endif
78 
79 #endif  /* TWL_CHT_ARM9_PICTOCATCH_H_ */
80 
81 /*---------------------------------------------------------------------------*
82   End of file
83  *---------------------------------------------------------------------------*/
84