Difference between revisions of "MCSGetDlen2"

From WikiPrizm
Jump to navigationJump to search
Line 1: Line 1:
== Synopsis ==
+
{{syscall
'''Header:''' mcs_syscalls.h
+
| name = MCSGetDlen2
 
+
| header = fxcg/file.h
'''Syscall:'''
+
| index = 0x154B
 
+
| signature = int MCSGetDlen2(unsigned char* dir, unsigned char* item, int* data_len)
'''Function declaration:''' int MCSGetDlen2(unsigned char* dir, unsigned char* item, int* data_len);
+
| synopsis = Gets the length in bytes of the item in main memory, and selects it for posterior usage by, for example, [[MCSGetData1]].
 
+
| parameters =
Gets the length in bytes of the item in main memory.
+
* ''unsigned char*'' '''dir''' - The name of the directory where the item is located.
 
 
=== Inputs ===
 
* ''unsigned char*'' '''dir''' - The name of the directory.
 
 
* ''unsigned char*'' '''item''' - The name of the item.
 
* ''unsigned char*'' '''item''' - The name of the item.
 
+
* ''int*'' '''data_len''' - Pointer to variable that will receive the length of the data.
=== Outputs ===
+
| returns = * 0 for success;
* ''int*'' '''data_len''' - The length of the data.
+
* other values on failure.
* '''0''' - Success
+
| comments = Selects '''dir'''\'''item''' as the item for [[MCSGetData1]] to operate with. As explained on its article, process switching (i.e. [[GetKey]]) can't occur between the calls to these syscalls.
* '''other''' - Failure
+
}}
 
+
[[Category:Syscalls:MCS]]
== Comments ==
 
Sets '''dir'''\'''item''' as the current item for [[MCSGetData1]].
 
 
 
Output could be error codes. Still needs investigation.
 
 
 
[[Category:Syscalls]][[Category:Main_Memory]]
 

Revision as of 10:11, 30 July 2014


Synopsis

Header: fxcg/file.h
Syscall index: 0x154B
Function signature: int MCSGetDlen2(unsigned char* dir, unsigned char* item, int* data_len)

Gets the length in bytes of the item in main memory, and selects it for posterior usage by, for example, MCSGetData1.

Parameters

  • unsigned char* dir - The name of the directory where the item is located.
  • unsigned char* item - The name of the item.
  • int* data_len - Pointer to variable that will receive the length of the data.

Returns

  • 0 for success;
  • other values on failure.

Comments

Selects dir\item as the item for MCSGetData1 to operate with. As explained on its article, process switching (i.e. GetKey) can't occur between the calls to these syscalls.