Vanara/PInvoke/Kernel32/WinBase.ProcessThread.cs

using System;
using System.Runtime.InteropServices;

namespace Vanara.PInvoke
{
	public static partial class Kernel32
	{
		/// <summary>
		/// An application-defined function used with the <c>CreateFiber</c> function. It serves as the starting address for a fiber. The
		/// <c>LPFIBER_START_ROUTINE</c> type defines a pointer to this callback function. <c>FiberProc</c> is a placeholder for the
		/// application-defined function name.
		/// </summary>
		/// <param name="lpParameter">The fiber data passed using the lpParameter parameter of the <c>CreateFiber</c> function.</param>
		/// <returns>This function does not return a value.</returns>
		// VOID CALLBACK FiberProc( _In_ PVOID lpParameter); https://msdn.microsoft.com/en-us/library/windows/desktop/ms682660(v=vs.85).aspx
		[UnmanagedFunctionPointer(CallingConvention.Winapi)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms682660")]
		public delegate void FiberProc(IntPtr lpParameter);

		/// <summary>The thread's execution requirements.</summary>
		public enum EXECUTION_STATE : uint
		{
			/// <summary>
			/// Enables away mode. This value must be specified with ES_CONTINUOUS.
			/// <para>
			/// Away mode should be used only by media-recording and media-distribution applications that must perform critical background
			/// processing on desktop computers while the computer appears to be sleeping. See Remarks.
			/// </para>
			/// </summary>
			ES_AWAYMODE_REQUIRED = 0x00000040,

			/// <summary>
			/// Informs the system that the state being set should remain in effect until the next call that uses ES_CONTINUOUS and one of
			/// the other state flags is cleared.
			/// </summary>
			ES_CONTINUOUS = 0x80000000,

			/// <summary>Forces the display to be on by resetting the display idle timer.</summary>
			ES_DISPLAY_REQUIRED = 0x00000002,

			/// <summary>Forces the system to be in the working state by resetting the system idle timer.</summary>
			ES_SYSTEM_REQUIRED = 0x00000001,

			/// <summary>
			/// This value is not supported. If ES_USER_PRESENT is combined with other esFlags values, the call will fail and none of the
			/// specified states will be set.
			/// </summary>
			ES_USER_PRESENT = 0x00000004,
		}

		/// <summary>Flags used by <see cref="ConvertThreadToFiberEx"/>.</summary>
		[PInvokeData("winbase.h", MSDNShortId = "cb0473f8-bc49-44c9-a8b7-6d5b55aa37a5")]
		public enum FIBER_FLAG
		{
			/// <summary>
			/// The floating-point state on x86 systems is not switched and data can be corrupted if a fiber uses floating-point arithmetic.
			/// </summary>
			FIBER_FLAG_NONE = 0,

			/// <summary>The floating-point state is switched for the fiber.</summary>
			FIBER_FLAG_FLOAT_SWITCH = 1,
		}

		/// <summary>Converts the current fiber into a thread.</summary>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// BOOL WINAPI ConvertFiberToThread(void); https://msdn.microsoft.com/en-us/library/windows/desktop/ms682112(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms682112")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool ConvertFiberToThread();

		/// <summary>Converts the current thread into a fiber. You must convert a thread into a fiber before you can schedule other fibers.</summary>
		/// <param name="lpParameter">
		/// A pointer to a variable that is passed to the fiber. The fiber can retrieve this data by using the <c>GetFiberData</c> macro.
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is the address of the fiber.</para>
		/// <para>If the function fails, the return value is NULL. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// LPVOID WINAPI ConvertThreadToFiber( _In_opt_ LPVOID lpParameter); https://msdn.microsoft.com/en-us/library/windows/desktop/ms682115(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms682115")]
		public static extern IntPtr ConvertThreadToFiber([In, Optional] IntPtr lpParameter);

		/// <summary>
		/// <para>Converts the current thread into a fiber. You must convert a thread into a fiber before you can schedule other fibers.</para>
		/// </summary>
		/// <param name="lpParameter">
		/// <para>A pointer to a variable that is passed to the fiber. The fiber can retrieve this data by using the GetFiberData macro.</para>
		/// </param>
		/// <param name="dwFlags">
		/// <para>
		/// If this parameter is zero, the floating-point state on x86 systems is not switched and data can be corrupted if a fiber uses
		/// floating-point arithmetic. If this parameter is FIBER_FLAG_FLOAT_SWITCH, the floating-point state is switched for the fiber.
		/// </para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is the address of the fiber.</para>
		/// <para>If the function fails, the return value is NULL. To get extended error information, call GetLastError.</para>
		/// </returns>
		/// <remarks>
		/// <para>
		/// Only fibers can execute other fibers. If a thread needs to execute a fiber, it must call ConvertTheadToFiber or
		/// <c>ConvertThreadToFiberEx</c> to create an area in which to save fiber state information. The thread is now the current fiber.
		/// The state information for this fiber includes the fiber data specified by .
		/// </para>
		/// <para>
		/// To compile an application that uses this function, define _WIN32_WINNT as 0x0400 or later. For more information, see Using the
		/// Windows Headers.
		/// </para>
		/// </remarks>
		// https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-convertthreadtofiberex LPVOID ConvertThreadToFiberEx(
		// LPVOID lpParameter, DWORD dwFlags );
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("winbase.h", MSDNShortId = "cb0473f8-bc49-44c9-a8b7-6d5b55aa37a5")]
		public static extern IntPtr ConvertThreadToFiberEx([In, Optional] IntPtr lpParameter, FIBER_FLAG dwFlags);

		/// <summary>
		/// Allocates a fiber object, assigns it a stack, and sets up execution to begin at the specified start address, typically the fiber
		/// function. This function does not schedule the fiber.
		/// </summary>
		/// <param name="dwStackSize">
		/// The initial size of the stack, in bytes. If this parameter is zero, the new fiber uses the default stack size for the executable.
		/// For more information, see Thread Stack Size.
		/// </param>
		/// <param name="lpStartAddress">
		/// A pointer to the application-defined function to be executed by the fiber and represents the starting address of the fiber.
		/// Execution of the newly created fiber does not begin until another fiber calls the SwitchToFiber function with this address. For
		/// more information of the fiber callback function, see FiberProc.
		/// </param>
		/// <param name="lpParameter">
		/// A pointer to a variable that is passed to the fiber. The fiber can retrieve this data by using the GetFiberData macro.
		/// </param>
		/// <returns>
		/// If the function succeeds, the return value is the address of the fiber. If the function fails, the return value is NULL.To get
		/// extended error information, call GetLastError.
		/// </returns>
		// VOID CALLBACK FiberProc( _In_ PVOID lpParameter); https://msdn.microsoft.com/en-us/library/windows/desktop/ms682402(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms682402")]
		public static extern IntPtr CreateFiber([Optional] SizeT dwStackSize, FiberProc lpStartAddress, [In, Optional] IntPtr lpParameter);

		/// <summary>
		/// Allocates a fiber object, assigns it a stack, and sets up execution to begin at the specified start address, typically the fiber
		/// function. This function does not schedule the fiber.
		/// </summary>
		/// <param name="dwStackCommitSize">
		/// The initial commit size of the stack, in bytes. If this parameter is zero, the new fiber uses the default commit stack size for
		/// the executable. For more information, see <c>Thread Stack Size</c>.
		/// </param>
		/// <param name="dwStackReserveSize">
		/// The initial reserve size of the stack, in bytes. If this parameter is zero, the new fiber uses the default reserved stack size
		/// for the executable. For more information, see <c>Thread Stack Size</c>.
		/// </param>
		/// <param name="dwFlags">
		/// <para>
		/// If this parameter is zero, the floating-point state on x86 systems is not switched and data can be corrupted if a fiber uses
		/// floating-point arithmetic. If this parameter is <c>FIBER_FLAG_FLOAT_SWITCH</c>, the floating-point state is switched for the fiber.
		/// </para>
		/// <para><c>Windows XP:</c> The <c>FIBER_FLAG_FLOAT_SWITCH</c> flag is not supported.</para>
		/// </param>
		/// <param name="lpStartAddress">
		/// A pointer to the application-defined function to be executed by the fiber and represents the starting address of the fiber.
		/// Execution of the newly created fiber does not begin until another fiber calls the <c>SwitchToFiber</c> function with this
		/// address. For more information on the fiber callback function, see <c>FiberProc</c>.
		/// </param>
		/// <param name="lpParameter">
		/// A pointer to a variable that is passed to the fiber. The fiber can retrieve this data by using the <c>GetFiberData</c> macro.
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is the address of the fiber.</para>
		/// <para>If the function fails, the return value is NULL. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// LPVOID WINAPI CreateFiberEx( _In_ SIZE_T dwStackCommitSize, _In_ SIZE_T dwStackReserveSize, _In_ DWORD dwFlags, _In_
		// LPFIBER_START_ROUTINE lpStartAddress, _In_opt_ LPVOID lpParameter); https://msdn.microsoft.com/en-us/library/windows/desktop/ms682406(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms682406")]
		public static extern IntPtr CreateFiberEx(SizeT dwStackCommitSize, SizeT dwStackReserveSize, FIBER_FLAG dwFlags, FiberProc lpStartAddress, [In, Optional] IntPtr lpParameter);

		/// <summary>Deletes an existing fiber.</summary>
		/// <param name="lpFiber">The address of the fiber to be deleted.</param>
		/// <returns>This function does not return a value.</returns>
		// VOID WINAPI DeleteFiber( _In_ LPVOID lpFiber); https://msdn.microsoft.com/en-us/library/windows/desktop/ms682556(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = false, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms682556")]
		public static extern void DeleteFiber([In] IntPtr lpFiber);

		/// <summary>Retrieves a pseudo handle for the current process.</summary>
		/// <returns>The return value is a pseudo handle to the current process.</returns>
		// HANDLE WINAPI GetCurrentProcess(void); https://msdn.microsoft.com/en-us/library/windows/desktop/ms683179(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = false, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms683179")]
		public static extern HPROCESS GetCurrentProcess();

		/// <summary>
		/// <para>Retrieves the amount of memory available in the specified node.</para>
		/// <para>Use the <c>GetNumaAvailableMemoryNodeEx</c> function to specify the node as a <c>USHORT</c> value.</para>
		/// </summary>
		/// <param name="Node">The number of the node.</param>
		/// <param name="AvailableBytes">The amount of available memory for the node, in bytes.</param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// BOOL WINAPI GetNumaAvailableMemoryNode( _In_ UCHAR Node, _Out_ PULONGLONG AvailableBytes); https://msdn.microsoft.com/en-us/library/windows/desktop/ms683202(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms683202")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetNumaAvailableMemoryNode(byte Node, out ulong AvailableBytes);

		/// <summary>
		/// <para>Retrieves the amount of memory that is available in a node specified as a <c>USHORT</c> value.</para>
		/// </summary>
		/// <param name="Node">
		/// <para>The number of the node.</para>
		/// </param>
		/// <param name="AvailableBytes">
		/// <para>The amount of available memory for the node, in bytes.</para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call GetLastError.</para>
		/// </returns>
		/// <remarks>
		/// <para>
		/// The <c>GetNumaAvailableMemoryNodeEx</c> function returns the amount of memory consumed by free and zeroed pages on the specified
		/// node. On systems with more than one node, this memory does not include standby pages. Therefore, the sum of the available memory
		/// values for all nodes in the system is equal to the value of the Free &amp; Zero Page List Bytes memory performance counter. On
		/// systems with only one node, the value returned by GetNumaAvailableMemoryNode includes standby pages and is equal to the value of
		/// the Available Bytes memory performance counter. For more information about performance counters, see Memory Performance Information.
		/// </para>
		/// <para>
		/// The only difference between the <c>GetNumaAvailableMemoryNodeEx</c> function and the GetNumaAvailableMemoryNode function is the
		/// data type of the Node parameter.
		/// </para>
		/// <para>
		/// To compile an application that uses this function, set _WIN32_WINNT &gt;= 0x0601. For more information, see Using the Windows Headers.
		/// </para>
		/// </remarks>
		// https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-getnumaavailablememorynodeex BOOL
		// GetNumaAvailableMemoryNodeEx( USHORT Node, PULONGLONG AvailableBytes );
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("winbase.h", MSDNShortId = "59382114-f3da-45e0-843e-51c0fd52a164")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetNumaAvailableMemoryNodeEx(ushort Node, out ulong AvailableBytes);

		/// <summary>
		/// <para>Retrieves the NUMA node associated with the file or I/O device represented by the specified file handle.</para>
		/// </summary>
		/// <param name="hFile">
		/// <para>
		/// A handle to a file or I/O device. Examples of I/O devices include files, file streams, volumes, physical disks, and sockets. For
		/// more information, see the CreateFile function.
		/// </para>
		/// </param>
		/// <param name="NodeNumber">
		/// <para>A pointer to a variable to receive the number of the NUMA node associated with the specified file handle.</para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, use GetLastError.</para>
		/// </returns>
		/// <remarks>
		/// <para>
		/// If the specified handle does not have a node associated with it, the function returns FALSE. The value of the NodeNumber
		/// parameter is undetermined and should not be used.
		/// </para>
		/// <para>
		/// To compile an application that uses this function, set _WIN32_WINNT &gt;= 0x0601. For more information, see Using the Windows Headers.
		/// </para>
		/// </remarks>
		// https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-getnumanodenumberfromhandle BOOL
		// GetNumaNodeNumberFromHandle( HANDLE hFile, PUSHORT NodeNumber );
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("winbase.h", MSDNShortId = "7622f7c9-2dfc-4ab7-b3e9-48d483c6cc0e")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetNumaNodeNumberFromHandle(HFILE hFile, out ushort NodeNumber);

		/// <summary>
		/// <para>Retrieves the processor mask for the specified node.</para>
		/// <para>Use the <c>GetNumaNodeProcessorMaskEx</c> function to retrieve the processor mask for a node in any processor group.</para>
		/// </summary>
		/// <param name="Node">The number of the node.</param>
		/// <param name="ProcessorMask">
		/// <para>
		/// The processor mask for the node. A processor mask is a bit vector in which each bit represents a processor and whether it is in
		/// the node.
		/// </para>
		/// <para>If the node has no processors configured, the processor mask is zero.</para>
		/// <para>
		/// On systems with more than 64 processors, this parameter is set to the processor mask for the node only if the node is in the same
		/// processor group as the calling thread. Otherwise, the parameter is set to zero.
		/// </para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// BOOL WINAPI GetNumaNodeProcessorMask( _In_ UCHAR Node, _Out_ PULONGLONG ProcessorMask); https://msdn.microsoft.com/en-us/library/windows/desktop/ms683204(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms683204")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetNumaNodeProcessorMask(byte Node, out ulong ProcessorMask);

		/// <summary>
		/// <para>Retrieves the node number for the specified processor.</para>
		/// <para>
		/// Use the <c>GetNumaProcessorNodeEx</c> function to specify a processor group and retrieve the node number as a <c>USHORT</c> value.
		/// </para>
		/// </summary>
		/// <param name="Processor">
		/// <para>The processor number.</para>
		/// <para>
		/// On a system with more than 64 logical processors, the processor number is relative to the processor group that contains the
		/// processor on which the calling thread is running.
		/// </para>
		/// </param>
		/// <param name="NodeNumber">The node number. If the processor does not exist, this parameter is 0xFF.</param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// BOOL WINAPI GetNumaProcessorNode( _In_ UCHAR Processor, _Out_ PUCHAR NodeNumber); https://msdn.microsoft.com/en-us/library/windows/desktop/ms683205(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms683205")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetNumaProcessorNode(byte Processor, out byte NodeNumber);

		/// <summary>
		/// <para>Retrieves the node number as a <c>USHORT</c> value for the specified logical processor.</para>
		/// </summary>
		/// <param name="Processor">
		/// <para>
		/// A pointer to a PROCESSOR_NUMBER structure that represents the logical processor and the processor group to which it is assigned.
		/// </para>
		/// </param>
		/// <param name="NodeNumber">
		/// <para>
		/// A pointer to a variable to receive the node number. If the specified processor does not exist, this parameter is set to MAXUSHORT.
		/// </para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call GetLastError.</para>
		/// </returns>
		/// <remarks>
		/// <para>
		/// To compile an application that uses this function, set _WIN32_WINNT &gt;= 0x0601. For more information, see Using the Windows Headers.
		/// </para>
		/// </remarks>
		// https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-getnumaprocessornodeex BOOL GetNumaProcessorNodeEx(
		// PPROCESSOR_NUMBER Processor, PUSHORT NodeNumber );
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("winbase.h", MSDNShortId = "6b843cd8-eeb5-4aa1-aad4-ce98916346b1")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetNumaProcessorNodeEx(in PROCESSOR_NUMBER Processor, out ushort NodeNumber);

		/// <summary>
		/// <para>Retrieves the NUMA node number that corresponds to the specified proximity domain identifier.</para>
		/// <para>Use the GetNumaProximityNodeEx function to retrieve the node number as a <c>USHORT</c> value.</para>
		/// </summary>
		/// <param name="ProximityId">
		/// <para>The proximity domain identifier of the node.</para>
		/// </param>
		/// <param name="NodeNumber">
		/// <para>The node number. If the processor does not exist, this parameter is 0xFF.</para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call GetLastError.</para>
		/// </returns>
		/// <remarks>
		/// <para>
		/// A proximity domain identifier is an index to a NUMA node on a NUMA system. Proximity domain identifiers are found in the ACPI
		/// System Resource Affinity Table (SRAT), where they are used to associate processors and memory regions with a particular NUMA
		/// node. Proximity domain identifiers are also found in the ACPI namespace, where they are used to associate a device with a
		/// particular NUMA node. Proximity domain identifiers are typically used only by management applications provided by system
		/// manufacturers. Windows does not use proximity domain identifiers to identify NUMA nodes; instead, it assigns a unique number to
		/// each NUMA node in the system.
		/// </para>
		/// <para>
		/// The relative distance between nodes on a system is stored in the ACPI System Locality Distance Information Table (SLIT), which is
		/// not exposed by any Windows functions. For more information about ACPI tables, see the ACPI specifications.
		/// </para>
		/// </remarks>
		// https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-getnumaproximitynode BOOL GetNumaProximityNode( ULONG
		// ProximityId, PUCHAR NodeNumber );
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("winbase.h", MSDNShortId = "9a2dbfe3-13e7-442d-a5f6-b2632878f618")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetNumaProximityNode(uint ProximityId, out byte NodeNumber);

		/// <summary>Retrieves the process affinity mask for the specified process and the system affinity mask for the system.</summary>
		/// <param name="hProcess">
		/// <para>A handle to the process whose affinity mask is desired.</para>
		/// <para>
		/// This handle must have the <c>PROCESS_QUERY_INFORMATION</c> or <c>PROCESS_QUERY_LIMITED_INFORMATION</c> access right. For more
		/// information, see Process Security and Access Rights.
		/// </para>
		/// <para><c>Windows Server 2003 and Windows XP:</c> The handle must have the <c>PROCESS_QUERY_INFORMATION</c> access right.</para>
		/// </param>
		/// <param name="lpProcessAffinityMask">A pointer to a variable that receives the affinity mask for the specified process.</param>
		/// <param name="lpSystemAffinityMask">A pointer to a variable that receives the affinity mask for the system.</param>
		/// <returns>
		/// <para>
		/// If the function succeeds, the return value is nonzero and the function sets the variables pointed to by lpProcessAffinityMask and
		/// lpSystemAffinityMask to the appropriate affinity masks.
		/// </para>
		/// <para>
		/// On a system with more than 64 processors, if the threads of the calling process are in a single processor group, the function
		/// sets the variables pointed to by lpProcessAffinityMask and lpSystemAffinityMask to the process affinity mask and the processor
		/// mask of active logical processors for that group. If the calling process contains threads in multiple groups, the function
		/// returns zero for both affinity masks.
		/// </para>
		/// <para>
		/// If the function fails, the return value is zero, and the values of the variables pointed to by lpProcessAffinityMask and
		/// lpSystemAffinityMask are undefined. To get extended error information, call <c>GetLastError</c>.
		/// </para>
		/// </returns>
		// BOOL WINAPI GetProcessAffinityMask( _In_ HANDLE hProcess, _Out_ PDWORD_PTR lpProcessAffinityMask, _Out_ PDWORD_PTR
		// lpSystemAffinityMask); https://msdn.microsoft.com/en-us/library/windows/desktop/ms683213(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms683213")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetProcessAffinityMask([In] HPROCESS hProcess, out UIntPtr lpProcessAffinityMask, out UIntPtr lpSystemAffinityMask);

		/// <summary>Retrieves accounting information for all I/O operations performed by the specified process.</summary>
		/// <param name="hProcess">
		/// <para>
		/// A handle to the process. The handle must have the <c>PROCESS_QUERY_INFORMATION</c> or <c>PROCESS_QUERY_LIMITED_INFORMATION</c>
		/// access right. For more information, see Process Security and Access Rights.
		/// </para>
		/// <para><c>Windows Server 2003 and Windows XP:</c> The handle must have the <c>PROCESS_QUERY_INFORMATION</c> access right.</para>
		/// </param>
		/// <param name="lpIoCounters">
		/// A pointer to an <c>IO_COUNTERS</c> structure that receives the I/O accounting information for the process.
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// BOOL WINAPI GetProcessIoCounters( _In_ HANDLE hProcess, _Out_ PIO_COUNTERS lpIoCounters); https://msdn.microsoft.com/en-us/library/windows/desktop/ms683218(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms683218")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetProcessIoCounters([In] HPROCESS hProcess, out IO_COUNTERS lpIoCounters);

		/// <summary>Retrieves the minimum and maximum working set sizes of the specified process.</summary>
		/// <param name="hProcess">
		/// <para>
		/// A handle to the process whose working set sizes will be obtained. The handle must have the <c>PROCESS_QUERY_INFORMATION</c> or
		/// <c>PROCESS_QUERY_LIMITED_INFORMATION</c> access right. For more information, see Process Security and Access Rights.
		/// </para>
		/// <para><c>Windows Server 2003 and Windows XP:</c> The handle must have the <c>PROCESS_QUERY_INFORMATION</c> access right.</para>
		/// </param>
		/// <param name="lpMinimumWorkingSetSize">
		/// A pointer to a variable that receives the minimum working set size of the specified process, in bytes. The virtual memory manager
		/// attempts to keep at least this much memory resident in the process whenever the process is active.
		/// </param>
		/// <param name="lpMaximumWorkingSetSize">
		/// A pointer to a variable that receives the maximum working set size of the specified process, in bytes. The virtual memory manager
		/// attempts to keep no more than this much memory resident in the process whenever the process is active when memory is in short supply.
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// </returns>
		// BOOL WINAPI GetProcessWorkingSetSize( _In_ HANDLE hProcess, _Out_ PSIZE_T lpMinimumWorkingSetSize, _Out_ PSIZE_T lpMaximumWorkingSetSize);
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms683226")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool GetProcessWorkingSetSize([In] HPROCESS hProcess, [Out] out SizeT lpMinimumWorkingSetSize, [Out] out SizeT lpMaximumWorkingSetSize);

		/// <summary>
		/// <para>
		/// Maps a view of a file mapping into the address space of a calling process and specifies the NUMA node for the physical memory.
		/// </para>
		/// </summary>
		/// <param name="hFileMappingObject">
		/// <para>A handle to a file mapping object. The CreateFileMappingNuma and OpenFileMapping functions return this handle.</para>
		/// </param>
		/// <param name="dwDesiredAccess">
		/// <para>
		/// The type of access to a file mapping object, which determines the page protection of the pages. This parameter can be one of the
		/// following values.
		/// </para>
		/// <list type="table">
		/// <listheader>
		/// <term>Value</term>
		/// <term>Meaning</term>
		/// </listheader>
		/// <item>
		/// <term>FILE_MAP_ALL_ACCESS</term>
		/// <term>
		/// A read/write view of the file is mapped. The file mapping object must have been created with PAGE_READWRITE or
		/// PAGE_EXECUTE_READWRITE protection. When used with the MapViewOfFileExNuma function, FILE_MAP_ALL_ACCESS is equivalent to FILE_MAP_WRITE.
		/// </term>
		/// </item>
		/// <item>
		/// <term>FILE_MAP_COPY</term>
		/// <term>
		/// A copy-on-write view of the file is mapped. The file mapping object must have been created with PAGE_READONLY, PAGE_READ_EXECUTE,
		/// PAGE_WRITECOPY, PAGE_EXECUTE_WRITECOPY, PAGE_READWRITE, or PAGE_EXECUTE_READWRITE protection. When a process writes to a
		/// copy-on-write page, the system copies the original page to a new page that is private to the process. The new page is backed by
		/// the paging file. The protection of the new page changes from copy-on-write to read/write. When copy-on-write access is specified,
		/// the system and process commit charge taken is for the entire view because the calling process can potentially write to every page
		/// in the view, making all pages private. The contents of the new page are never written back to the original file and are lost when
		/// the view is unmapped.
		/// </term>
		/// </item>
		/// <item>
		/// <term>FILE_MAP_READ</term>
		/// <term>
		/// A read-only view of the file is mapped. An attempt to write to the file view results in an access violation. The file mapping
		/// object must have been created with PAGE_READONLY, PAGE_READWRITE, PAGE_EXECUTE_READ, or PAGE_EXECUTE_READWRITE protection.
		/// </term>
		/// </item>
		/// <item>
		/// <term>FILE_MAP_WRITE</term>
		/// <term>
		/// A read/write view of the file is mapped. The file mapping object must have been created with PAGE_READWRITE or
		/// PAGE_EXECUTE_READWRITE protection. When used with MapViewOfFileExNuma, and FILE_MAP_ALL_ACCESS are equivalent to FILE_MAP_WRITE.
		/// </term>
		/// </item>
		/// </list>
		/// <para>Each of the preceding values can be combined with the following value.</para>
		/// <list type="table">
		/// <listheader>
		/// <term>Value</term>
		/// <term>Meaning</term>
		/// </listheader>
		/// <item>
		/// <term>FILE_MAP_EXECUTE</term>
		/// <term>
		/// An executable view of the file is mapped (mapped memory can be run as code). The file mapping object must have been created with
		/// PAGE_EXECUTE_READ, PAGE_EXECUTE_WRITECOPY, or PAGE_EXECUTE_READWRITE protection.
		/// </term>
		/// </item>
		/// </list>
		/// <para>
		/// For file mapping objects created with the <c>SEC_IMAGE</c> attribute, the dwDesiredAccess parameter has no effect and should be
		/// set to any valid value such as <c>FILE_MAP_READ</c>.
		/// </para>
		/// <para>For more information about access to file mapping objects, see File Mapping Security and Access Rights.</para>
		/// </param>
		/// <param name="dwFileOffsetHigh">
		/// <para>The high-order <c>DWORD</c> of the file offset where the view is to begin.</para>
		/// </param>
		/// <param name="dwFileOffsetLow">
		/// <para>
		/// The low-order <c>DWORD</c> of the file offset where the view is to begin. The combination of the high and low offsets must
		/// specify an offset within the file mapping. They must also match the memory allocation granularity of the system. That is, the
		/// offset must be a multiple of the allocation granularity. To obtain the memory allocation granularity of the system, use the
		/// GetSystemInfo function, which fills in the members of a SYSTEM_INFO structure.
		/// </para>
		/// </param>
		/// <param name="dwNumberOfBytesToMap">
		/// <para>
		/// The number of bytes of a file mapping to map to a view. All bytes must be within the maximum size specified by CreateFileMapping.
		/// If this parameter is 0 (zero), the mapping extends from the specified offset to the end of the file mapping.
		/// </para>
		/// </param>
		/// <param name="lpBaseAddress">
		/// <para>
		/// A pointer to the memory address in the calling process address space where mapping begins. This must be a multiple of the
		/// system's memory allocation granularity, or the function fails. To determine the memory allocation granularity of the system, use
		/// the GetSystemInfo function. If there is not enough address space at the specified address, the function fails.
		/// </para>
		/// <para>If the lpBaseAddress parameter is <c>NULL</c>, the operating system chooses the mapping address.</para>
		/// <para>
		/// While it is possible to specify an address that is safe now (not used by the operating system), there is no guarantee that the
		/// address will remain safe over time. Therefore, it is better to let the operating system choose the address. In this case, you
		/// would not store pointers in the memory mapped file; you would store offsets from the base of the file mapping so that the mapping
		/// can be used at any address.
		/// </para>
		/// </param>
		/// <param name="nndPreferred">
		/// <para>The NUMA node where the physical memory should reside.</para>
		/// <list type="table">
		/// <listheader>
		/// <term>Value</term>
		/// <term>Meaning</term>
		/// </listheader>
		/// <item>
		/// <term>NUMA_NO_PREFERRED_NODE 0xffffffff</term>
		/// <term>No NUMA node is preferred. This is the same as calling the MapViewOfFileEx function.</term>
		/// </item>
		/// </list>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is the starting address of the mapped view.</para>
		/// <para>If the function fails, the return value is <c>NULL</c>. To get extended error information, call the GetLastError function.</para>
		/// </returns>
		/// <remarks>
		/// <para>Mapping a file makes the specified portion of the file visible in the address space of the calling process.</para>
		/// <para>
		/// For files that are larger than the address space, you can map only a small portion of the file data at one time. When the first
		/// view is complete, then you unmap it and map a new view.
		/// </para>
		/// <para>To obtain the size of a view, use the VirtualQueryEx function.</para>
		/// <para>The initial contents of the pages in a file mapping object backed by the page file are 0 (zero).</para>
		/// <para>
		/// If a suggested mapping address is supplied, the file is mapped at the specified address (rounded down to the nearest 64-KB
		/// boundary) if there is enough address space at the specified address. If there is not enough address space, the function fails.
		/// </para>
		/// <para>
		/// Typically, the suggested address is used to specify that a file should be mapped at the same address in multiple processes. This
		/// requires the region of address space to be available in all involved processes. No other memory allocation can take place in the
		/// region that is used for mapping, including the use of the VirtualAllocExNuma function to reserve memory.
		/// </para>
		/// <para>
		/// If the lpBaseAddress parameter specifies a base offset, the function succeeds if the specified memory region is not already in
		/// use by the calling process. The system does not ensure that the same memory region is available for the memory mapped file in
		/// other 32-bit processes.
		/// </para>
		/// <para>
		/// Multiple views of a file (or a file mapping object and its mapped file) are coherent if they contain identical data at a
		/// specified time. This occurs if the file views are derived from the same file mapping object. A process can duplicate a file
		/// mapping object handle into another process by using the DuplicateHandle function, or another process can open a file mapping
		/// object by name by using the OpenFileMapping function.
		/// </para>
		/// <para>
		/// With one important exception, file views derived from any file mapping object that is backed by the same file are coherent or
		/// identical at a specific time. Coherency is guaranteed for views within a process and for views that are mapped by different processes.
		/// </para>
		/// <para>
		/// The exception is related to remote files. Although <c>MapViewOfFileExNuma</c> works with remote files, it does not keep them
		/// coherent. For example, if two computers both map a file as writable, and both change the same page, each computer only sees its
		/// own writes to the page. When the data gets updated on the disk, it is not merged.
		/// </para>
		/// <para>A mapped view of a file is not guaranteed to be coherent with a file being accessed by the ReadFile or WriteFile function.</para>
		/// <para>
		/// To guard against <c>EXCEPTION_IN_PAGE_ERROR</c> exceptions, use structured exception handling to protect any code that writes to
		/// or reads from a memory mapped view of a file other than the page file. For more information, see Reading and Writing From a File View.
		/// </para>
		/// <para>
		/// When modifying a file through a mapped view, the last modification timestamp may not be updated automatically. If required, the
		/// caller should use SetFileTime to set the timestamp.
		/// </para>
		/// <para>
		/// To have a file with executable permissions, an application must call the CreateFileMappingNuma function with either
		/// <c>PAGE_EXECUTE_READWRITE</c> or <c>PAGE_EXECUTE_READ</c> and then call the <c>MapViewOfFileExNuma</c> function with
		/// <c>FILE_MAP_EXECUTE</c> | <c>FILE_MAP_WRITE</c> or <c>FILE_MAP_EXECUTE</c> | <c>FILE_MAP_READ</c>.
		/// </para>
		/// <para>In Windows Server 2012, this function is supported by the following technologies.</para>
		/// <list type="table">
		/// <listheader>
		/// <term>Technology</term>
		/// <term>Supported</term>
		/// </listheader>
		/// <item>
		/// <term>Server Message Block (SMB) 3.0 protocol</term>
		/// <term>Yes</term>
		/// </item>
		/// <item>
		/// <term>SMB 3.0 Transparent Failover (TFO)</term>
		/// <term>Yes</term>
		/// </item>
		/// <item>
		/// <term>SMB 3.0 with Scale-out File Shares (SO)</term>
		/// <term>Yes</term>
		/// </item>
		/// <item>
		/// <term>Cluster Shared Volume File System (CsvFS)</term>
		/// <term>Yes</term>
		/// </item>
		/// <item>
		/// <term>Resilient File System (ReFS)</term>
		/// <term>Yes</term>
		/// </item>
		/// </list>
		/// </remarks>
		// https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-mapviewoffileexnuma LPVOID MapViewOfFileExNuma( HANDLE
		// hFileMappingObject, DWORD dwDesiredAccess, DWORD dwFileOffsetHigh, DWORD dwFileOffsetLow, SIZE_T dwNumberOfBytesToMap, LPVOID
		// lpBaseAddress, DWORD nndPreferred );
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("winbase.h", MSDNShortId = "1e28c8db-112d-481d-b470-8ca618e125ce")]
		public static extern IntPtr MapViewOfFileExNuma(HSECTION hFileMappingObject, FILE_MAP dwDesiredAccess, uint dwFileOffsetHigh, uint dwFileOffsetLow, SizeT dwNumberOfBytesToMap, IntPtr lpBaseAddress, uint nndPreferred);

		/// <summary>Sets a processor affinity mask for the threads of the specified process.</summary>
		/// <param name="hProcess">
		/// A handle to the process whose affinity mask is to be set. This handle must have the <c>PROCESS_SET_INFORMATION</c> access right.
		/// For more information, see Process Security and Access Rights.
		/// </param>
		/// <param name="dwProcessAffinityMask">
		/// <para>The affinity mask for the threads of the process.</para>
		/// <para>On a system with more than 64 processors, the affinity mask must specify processors in a single processor group.</para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// <para>If the process affinity mask requests a processor that is not configured in the system, the last error code is <c>ERROR_INVALID_PARAMETER</c>.</para>
		/// <para>
		/// On a system with more than 64 processors, if the calling process contains threads in more than one processor group, the last
		/// error code is <c>ERROR_INVALID_PARAMETER</c>.
		/// </para>
		/// </returns>
		// BOOL WINAPI SetProcessAffinityMask( _In_ HANDLE hProcess, _In_ DWORD_PTR dwProcessAffinityMask); https://msdn.microsoft.com/en-us/library/windows/desktop/ms686223(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms686223")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool SetProcessAffinityMask([In] HPROCESS hProcess, UIntPtr dwProcessAffinityMask);

		/// <summary>Sets the minimum and maximum working set sizes for the specified process.</summary>
		/// <param name="hProcess">
		/// <para>A handle to the process whose working set sizes is to be set.</para>
		/// <para>
		/// The handle must have the <c>PROCESS_SET_QUOTA</c> access right. For more information, see Process Security and Access Rights.
		/// </para>
		/// </param>
		/// <param name="dwMinimumWorkingSetSize">
		/// <para>
		/// The minimum working set size for the process, in bytes. The virtual memory manager attempts to keep at least this much memory
		/// resident in the process whenever the process is active.
		/// </para>
		/// <para>
		/// This parameter must be greater than zero but less than or equal to the maximum working set size. The default size is 50 pages
		/// (for example, this is 204,800 bytes on systems with a 4K page size). If the value is greater than zero but less than 20 pages,
		/// the minimum value is set to 20 pages.
		/// </para>
		/// <para>
		/// If both dwMinimumWorkingSetSize and dwMaximumWorkingSetSize have the value ( <c>SIZE_T</c>)–1, the function removes as many pages
		/// as possible from the working set of the specified process.
		/// </para>
		/// </param>
		/// <param name="dwMaximumWorkingSetSize">
		/// <para>
		/// The maximum working set size for the process, in bytes. The virtual memory manager attempts to keep no more than this much memory
		/// resident in the process whenever the process is active and available memory is low.
		/// </para>
		/// <para>
		/// This parameter must be greater than or equal to 13 pages (for example, 53,248 on systems with a 4K page size), and less than the
		/// system-wide maximum (number of available pages minus 512 pages). The default size is 345 pages (for example, this is 1,413,120
		/// bytes on systems with a 4K page size).
		/// </para>
		/// <para>
		/// If both dwMinimumWorkingSetSize and dwMaximumWorkingSetSize have the value ( <c>SIZE_T</c>)–1, the function removes as many pages
		/// as possible from the working set of the specified process.
		/// </para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is nonzero.</para>
		/// <para>If the function fails, the return value is zero. Call <c>GetLastError</c> to obtain extended error information.</para>
		/// </returns>
		// BOOL WINAPI SetProcessWorkingSetSize( _In_ HANDLE hProcess, _In_ SIZE_T dwMinimumWorkingSetSize, _In_ SIZE_T
		// dwMaximumWorkingSetSize); https://msdn.microsoft.com/en-us/library/windows/desktop/ms686234(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms686234")]
		[return: MarshalAs(UnmanagedType.Bool)]
		public static extern bool SetProcessWorkingSetSize([In] HPROCESS hProcess, SizeT dwMinimumWorkingSetSize, SizeT dwMaximumWorkingSetSize);

		/// <summary>Sets a processor affinity mask for the specified thread.</summary>
		/// <param name="hThread">
		/// <para>A handle to the thread whose affinity mask is to be set.</para>
		/// <para>
		/// This handle must have the <c>THREAD_SET_INFORMATION</c> or <c>THREAD_SET_LIMITED_INFORMATION</c> access right and the
		/// <c>THREAD_QUERY_INFORMATION</c> or <c>THREAD_QUERY_LIMITED_INFORMATION</c> access right. For more information, see Thread
		/// Security and Access Rights.
		/// </para>
		/// <para>
		/// <c>Windows Server 2003 and Windows XP:</c> The handle must have the <c>THREAD_SET_INFORMATION</c> and
		/// <c>THREAD_QUERY_INFORMATION</c> access rights.
		/// </para>
		/// </param>
		/// <param name="dwThreadAffinityMask">
		/// <para>The affinity mask for the thread.</para>
		/// <para>
		/// On a system with more than 64 processors, the affinity mask must specify processors in the thread's current processor group.
		/// </para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is the thread's previous affinity mask.</para>
		/// <para>If the function fails, the return value is zero. To get extended error information, call <c>GetLastError</c>.</para>
		/// <para>
		/// If the thread affinity mask requests a processor that is not selected for the process affinity mask, the last error code is <c>ERROR_INVALID_PARAMETER</c>.
		/// </para>
		/// </returns>
		// DWORD_PTR WINAPI SetThreadAffinityMask( _In_ HANDLE hThread, _In_ DWORD_PTR dwThreadAffinityMask); https://msdn.microsoft.com/en-us/library/windows/desktop/ms686247(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = true, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms686247")]
		public static extern UIntPtr SetThreadAffinityMask([In] HTHREAD hThread, UIntPtr dwThreadAffinityMask);

		/// <summary>
		/// Enables an application to inform the system that it is in use, thereby preventing the system from entering sleep or turning off
		/// the display while the application is running.
		/// </summary>
		/// <param name="esFlags">
		/// <para>The thread's execution requirements. This parameter can be one or more of the following values.</para>
		/// <para>
		/// <list type="table">
		/// <listheader>
		/// <term>Value</term>
		/// <term>Meaning</term>
		/// </listheader>
		/// <item>
		/// <term>ES_AWAYMODE_REQUIRED0x00000040</term>
		/// <term>
		/// Enables away mode. This value must be specified with ES_CONTINUOUS.Away mode should be used only by media-recording and
		/// media-distribution applications that must perform critical background processing on desktop computers while the computer appears
		/// to be sleeping. See Remarks.
		/// </term>
		/// </item>
		/// <item>
		/// <term>ES_CONTINUOUS0x80000000</term>
		/// <term>
		/// Informs the system that the state being set should remain in effect until the next call that uses ES_CONTINUOUS and one of the
		/// other state flags is cleared.
		/// </term>
		/// </item>
		/// <item>
		/// <term>ES_DISPLAY_REQUIRED0x00000002</term>
		/// <term>Forces the display to be on by resetting the display idle timer.</term>
		/// </item>
		/// <item>
		/// <term>ES_SYSTEM_REQUIRED0x00000001</term>
		/// <term>Forces the system to be in the working state by resetting the system idle timer.</term>
		/// </item>
		/// <item>
		/// <term>ES_USER_PRESENT0x00000004</term>
		/// <term>
		/// This value is not supported. If ES_USER_PRESENT is combined with other esFlags values, the call will fail and none of the
		/// specified states will be set.
		/// </term>
		/// </item>
		/// </list>
		/// </para>
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is the previous thread execution state.</para>
		/// <para>If the function fails, the return value is <c>NULL</c>.</para>
		/// </returns>
		// EXECUTION_STATE WINAPI SetThreadExecutionState( _In_ EXECUTION_STATE esFlags); https://msdn.microsoft.com/en-us/library/windows/desktop/aa373208(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = false, ExactSpelling = true)]
		[PInvokeData("Winbase.h", MSDNShortId = "aa373208")]
		public static extern EXECUTION_STATE SetThreadExecutionState(EXECUTION_STATE esFlags);

		/// <summary>Schedules a fiber. The function must be called on a fiber.</summary>
		/// <param name="lpFiber">The address of the fiber to be scheduled.</param>
		/// <returns>This function does not return a value.</returns>
		// VOID WINAPI SwitchToFiber( _In_ LPVOID lpFiber); https://msdn.microsoft.com/en-us/library/windows/desktop/ms686350(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = false, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms686350")]
		public static extern void SwitchToFiber([In] IntPtr lpFiber);

		/// <summary>Runs the specified application.</summary>
		/// <param name="lpCmdLine">
		/// The command line (file name plus optional parameters) for the application to be executed. If the name of the executable file in
		/// the lpCmdLine parameter does not contain a directory path, the system searches for the executable file in this sequence:
		/// </param>
		/// <param name="uCmdShow">
		/// The display options. For a list of the acceptable values, see the description of the nCmdShow parameter of the <c>ShowWindow</c> function.
		/// </param>
		/// <returns>
		/// <para>If the function succeeds, the return value is greater than 31.</para>
		/// <para>If the function fails, the return value is one of the following error values.</para>
		/// <para>
		/// <list type="table">
		/// <listheader>
		/// <term>Return code/value</term>
		/// <term>Description</term>
		/// </listheader>
		/// <item>
		/// <term>0</term>
		/// <term>The system is out of memory or resources.</term>
		/// </item>
		/// <item>
		/// <term>ERROR_BAD_FORMAT</term>
		/// <term>The .exe file is invalid.</term>
		/// </item>
		/// <item>
		/// <term>ERROR_FILE_NOT_FOUND</term>
		/// <term>The specified file was not found.</term>
		/// </item>
		/// <item>
		/// <term>ERROR_PATH_NOT_FOUND</term>
		/// <term>The specified path was not found.</term>
		/// </item>
		/// </list>
		/// </para>
		/// </returns>
		// UINT WINAPI WinExec( _In_ LPCSTR lpCmdLine, _In_ UINT uCmdShow); https://msdn.microsoft.com/en-us/library/windows/desktop/ms687393(v=vs.85).aspx
		[DllImport(Lib.Kernel32, SetLastError = false, ExactSpelling = true)]
		[PInvokeData("WinBase.h", MSDNShortId = "ms687393")]
		public static extern uint WinExec([In, MarshalAs(UnmanagedType.LPStr)] string lpCmdLine, ShowWindowCommand uCmdShow);
	}
}