Difference between revisions of "NWMUDS:GetConnectionStatus"

From 3dbrew
Jump to navigation Jump to search
Line 84: Line 84:
  
 
=Description=
 
=Description=
This is mainly used when the event handle from [[NWMUDS:Initialize]] is signalled. This is also used before using [[NWMUDS:Bind]]. For certain user-processes this may be used during NWMUDS initialization as well.
+
This is mainly used when the event handle from [[NWMUDS:Initialize]] is signaled. This is also used before using [[NWMUDS:Bind]]. For certain user-processes this may be used during NWMUDS initialization as well.
  
The event is not signalled when using [[NWMUDS:DestroyNetwork]] or [[NWMUDS:DisconnectNetwork]]. However the event does get signalled when creating or connecting to a network.
+
The event is not signaled when using [[NWMUDS:DestroyNetwork]] or [[NWMUDS:DisconnectNetwork]]. However the event does get signaled when creating or connecting to a network.

Revision as of 05:13, 8 April 2016

Request

Index Word Description
0 Header code [0x000B0000]

Response

Index Word Description
0 Header code
1 Result code
2-13 Output 0x30-byte structure.

Output structure

Offset Size Description
0x0 0x4 u32 status
0x4 0x4 Unknown u32. Official user-processes check for values: 0x0, 0x1, and non-zero.
0x8 0x2 u16 NetworkNodeID for this device.
0xA 0x22 ?
0x2C 0x1 u8 total_nodes.
0x2D 0x1 u8 max_nodes, originally from the NetworkStruct.
0x2E 0x2 u16 node_bitmask. This is a bitmask of NetworkNodeIDs: bit0 for NetworkNodeID 0x1(host), bit1 for NetworkNodeID 0x2(first original client), and so on.

Status values

Type Description
0x3 Not connected to any network as a host/client.
0x6 Connected to a network as a host.
0x9 Connected to a network as a client.
0xA Connected to a network as a spectator.
0xB For this value official user-processes use NWMUDS:UpdateNetworkAttribute to clear attributes bitmask 0x6.

Description

This is mainly used when the event handle from NWMUDS:Initialize is signaled. This is also used before using NWMUDS:Bind. For certain user-processes this may be used during NWMUDS initialization as well.

The event is not signaled when using NWMUDS:DestroyNetwork or NWMUDS:DisconnectNetwork. However the event does get signaled when creating or connecting to a network.