mirror of
https://github.com/Ed94/Odin.git
synced 2026-08-05 07:08:48 +00:00
[os2/process]: Adjust documentation for process info
This commit is contained in:
+13
-13
@@ -166,15 +166,15 @@ Process_Info :: struct {
|
|||||||
|
|
||||||
This procedure obtains an information, specified by `selection` parameter of
|
This procedure obtains an information, specified by `selection` parameter of
|
||||||
a process given by `pid`.
|
a process given by `pid`.
|
||||||
|
|
||||||
Use `free_process_info` to free the memory allocated by this procedure. In
|
Use `free_process_info` to free the memory allocated by this procedure. The
|
||||||
case the function returns an error it may only have been an error for one part
|
`free_process_info` procedure needs to be called, even if this procedure
|
||||||
of the information and you would still need to call it to free the other parts.
|
returned an error, as some of the fields have been allocated.
|
||||||
|
|
||||||
**Note**: The resulting information may or may contain the fields specified
|
**Note**: The resulting information may or may contain the fields specified
|
||||||
by the `selection` parameter. Always check whether the returned
|
by the `selection` parameter. Always check whether the returned
|
||||||
`Process_Info` struct has the required fields before checking the error code
|
`Process_Info` struct has the required fields before checking the error code
|
||||||
returned by this function.
|
returned by this procedure.
|
||||||
*/
|
*/
|
||||||
@(require_results)
|
@(require_results)
|
||||||
process_info_by_pid :: proc(pid: int, selection: Process_Info_Fields, allocator: runtime.Allocator) -> (Process_Info, Error) {
|
process_info_by_pid :: proc(pid: int, selection: Process_Info_Fields, allocator: runtime.Allocator) -> (Process_Info, Error) {
|
||||||
@@ -188,14 +188,14 @@ process_info_by_pid :: proc(pid: int, selection: Process_Info_Fields, allocator:
|
|||||||
about a process that has been opened by the application, specified in
|
about a process that has been opened by the application, specified in
|
||||||
the `process` parameter.
|
the `process` parameter.
|
||||||
|
|
||||||
Use `free_process_info` to free the memory allocated by this procedure. In
|
Use `free_process_info` to free the memory allocated by this procedure. The
|
||||||
case the function returns an error it may only have been an error for one part
|
`free_process_info` procedure needs to be called, even if this procedure
|
||||||
of the information and you would still need to call it to free the other parts.
|
returned an error, as some of the fields have been allocated.
|
||||||
|
|
||||||
**Note**: The resulting information may or may contain the fields specified
|
**Note**: The resulting information may or may contain the fields specified
|
||||||
by the `selection` parameter. Always check whether the returned
|
by the `selection` parameter. Always check whether the returned
|
||||||
`Process_Info` struct has the required fields before checking the error code
|
`Process_Info` struct has the required fields before checking the error code
|
||||||
returned by this function.
|
returned by this procedure.
|
||||||
*/
|
*/
|
||||||
@(require_results)
|
@(require_results)
|
||||||
process_info_by_handle :: proc(process: Process, selection: Process_Info_Fields, allocator: runtime.Allocator) -> (Process_Info, Error) {
|
process_info_by_handle :: proc(process: Process, selection: Process_Info_Fields, allocator: runtime.Allocator) -> (Process_Info, Error) {
|
||||||
@@ -208,14 +208,14 @@ process_info_by_handle :: proc(process: Process, selection: Process_Info_Fields,
|
|||||||
This procedure obtains the information, specified by `selection` parameter
|
This procedure obtains the information, specified by `selection` parameter
|
||||||
about the currently running process.
|
about the currently running process.
|
||||||
|
|
||||||
Use `free_process_info` to free the memory allocated by this procedure. In
|
Use `free_process_info` to free the memory allocated by this procedure. The
|
||||||
case the function returns an error it may only have been an error for one part
|
`free_process_info` procedure needs to be called, even if this procedure
|
||||||
of the information and you would still need to call it to free the other parts.
|
returned an error, as some of the fields have been allocated.
|
||||||
|
|
||||||
**Note**: The resulting information may or may contain the fields specified
|
**Note**: The resulting information may or may contain the fields specified
|
||||||
by the `selection` parameter. Always check whether the returned
|
by the `selection` parameter. Always check whether the returned
|
||||||
`Process_Info` struct has the required fields before checking the error code
|
`Process_Info` struct has the required fields before checking the error code
|
||||||
returned by this function.
|
returned by this procedure.
|
||||||
*/
|
*/
|
||||||
@(require_results)
|
@(require_results)
|
||||||
current_process_info :: proc(selection: Process_Info_Fields, allocator: runtime.Allocator) -> (Process_Info, Error) {
|
current_process_info :: proc(selection: Process_Info_Fields, allocator: runtime.Allocator) -> (Process_Info, Error) {
|
||||||
|
|||||||
Reference in New Issue
Block a user