Riverside.Win32

Win32 P/Invoke bindings for .NET Standard.

---

This library offers static generations of P/Invoke for all languages using custom MSBuild tasks to build CsWin32 generations from metadata. It uses custom PowerShell scripts and MSBuild tasks to build libraries, and is attached to a CD workflow that publishes the packages on NuGet.

You can then use the packages just as you would with CsWin32, but installing the correct package (relevant to the link library) to get the correct information, or installing the 'aggregate' package that contains all the Win32 P/Invoke methods and supporting types generated from the Win32 metadata repo.

---

The best way to consume Win32 P/Invoke APIs via this collection of libraries is by using the built-in alias system. Since all P/Invoke APIs across all packages generate into the same Windows.Win32.PInvoke class, you must use the correct alias to reference the correct version of the PInvoke class to call the P/Invoke APIs for that API set (DLL). For example, the following extract performs the SetPixel function from gdi32.dll:

extern alias gdi32; // important: you must reference the appropriate alias for the API you are calling

gdi32::Windows.Win32.Graphics.Gdi.HDC context = new(nint.Zero); // the hdc (device context) parameter in SetPixel
int x = 1; // the x coordinate parameter in SetPixel
int y = 1; // the y coordinate parameter in SetPixel
gdi32::Windows.Win32.Foundation.COLORREF white = new(0x00FFFFFF); // the colour parameter in SetPixel

gdi32::Windows.Win32.Foundation.COLORREF pixel = gdi32::Windows.Win32.PInvoke(context, x, y, white);

In practice, you might prefer to use a nicer, using statement, rather than repeating the alias throughout the document:

extern alias gdi32;

using gdi32::Windows.Win32;

// Then you can reference the P/Invoke APIs like so:
PInvoke.SetPixel();

Or, optionally, if you need access to P/Invoke APIs from multiple Win32 API sets but want to keep your codebase clean:

extern alias gdi32;
extern alias advapi32;

using GraphicsPInvoke = gdi32::Windows.Win32.PInvoke;
using AdvancedPInvoke = advapi32::Windows.Win32.PInvoke;

GraphicsPInvoke.SetPixel();
AdvancedPInvoke.CreateService();

---

Package name	NuGet download	Associated API set
Riverside.Win32		*
Riverside.Win32.Advanced		advapi32.dll
Riverside.Win32.Cabinet		cabinet.dll
Riverside.Win32.CommonControls		comctl32.dll
Riverside.Win32.Cryptography.BCrypt		bcrypt.dll
Riverside.Win32.Cryptography.Legacy		crypt32.dll
Riverside.Win32.Cryptography.NCrypt		ncrypt.dll
Riverside.Win32.Debugging		dbghelp.dll
Riverside.Win32.Desktop		dwmapi.dll
Riverside.Win32.DirectX.Direct3D.10		d3d10.dll
Riverside.Win32.DirectX.Direct3D.10.1		d3d10_1.dll
Riverside.Win32.DirectX.Direct3D.11		d3d11.dll
Riverside.Win32.DirectX.Direct3D.12		d3d12.dll
Riverside.Win32.DirectX.Direct3D.9		d3d9.dll
Riverside.Win32.DirectX.DirectInput		dinput8.dll
Riverside.Win32.DirectX.DirectSound		dsound.dll
Riverside.Win32.DirectX.GraphicsInfrastructure		dxgi.dll
Riverside.Win32.Graphics		gdi32.dll
Riverside.Win32.Graphics.OpenGL		opengl32.dll
Riverside.Win32.Graphics.OpenGLUtility		glu32.dll
Riverside.Win32.Hardware		cfgmgr32.dll
Riverside.Win32.InputMethod		imm32.dll
Riverside.Win32.Installer		msi.dll
Riverside.Win32.Kernel		kernel32.dll
Riverside.Win32.KernelStreaming		ksuser.dll
Riverside.Win32.Magnification		magnification.dll
Riverside.Win32.MediaFoundation		mf.dll
Riverside.Win32.MediaFoundation.Platform		mfplat.dll
Riverside.Win32.MediaFoundation.ReadWrite		mfreadwrite.dll
Riverside.Win32.Multimedia		winmm.dll
Riverside.Win32.Multimedia.Realtime		avrt.dll
Riverside.Win32.MultipleProviderRouter		mpr.dll
Riverside.Win32.NETFramework		mscoree.dll
Riverside.Win32.Network		netapi32.dll
Riverside.Win32.Network.IPHelper		iphlpapi.dll
Riverside.Win32.Networking.Internet		wininet.dll
Riverside.Win32.Networking.Sockets		ws2_32.dll
Riverside.Win32.NewDevice		newdev.dll
Riverside.Win32.NewTechnology		ntdll.dll
Riverside.Win32.ObjectLinking		ole32.dll
Riverside.Win32.ObjectLinking.Automation		oleaut32.dll
Riverside.Win32.PEImage		imagehlp.dll
Riverside.Win32.Process		psapi.dll
Riverside.Win32.RemoteDesktop		wtsapi32.dll
Riverside.Win32.Rpc		rpcrt4.dll
Riverside.Win32.Security		secur32.dll
Riverside.Win32.Setup		setupapi.dll
Riverside.Win32.Shell		shell32.dll
Riverside.Win32.Shell.Lightweight		shlwapi.dll
Riverside.Win32.Themes		uxtheme.dll
Riverside.Win32.Usb		winusb.dll
Riverside.Win32.Usb.HumanInterface		hid.dll
Riverside.Win32.UserEnvironment		userenv.dll
Riverside.Win32.UserInterface		user32.dll
Riverside.Win32.Version		version.dll