pinvoke.net: Edit: coredll.waveOutOpen

@msdn=http://search.microsoft.com/search/results.aspx?qu=$$$
@pinvoke=http://pinvoke.net/$$$.htm

Summary: This gives a pointer to the device for ouputing wav information

!!!!C# Signature:
[DllImport ("coredll.dll")]
private static extern MMSYSERR waveOutOpen(ref IntPtr phwo, uint uDeviceID, ref WAVEFORMATEX pwfx, uint dwCallback, uint dwInstance, uint fdwOpen );

!!!!VB Signature:
(TODO) As TODO
!!!!User-Defined Types:
None.

!!!!Alternative Managed API:
winmm.dll

!!!!Notes:
Taken from "Using P/Invoke to Call Unmanaged APIs from Your Managed Classes" found here:
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dv_vstechart/html/pinvoke.asp

!!!!Tips & Tricks:
Some of the sample code on MSDN as part of the PInvoke library gave the dllimport syntax like this:

[DllImport ("coredll.dll")]
private static extern Wave.MMSYSERR waveOutOpen(ref IntPtr phwo, uint uDeviceID, Wave.WAVEFORMATEX pwfx, IntPtr dwCallback, uint dwInstance, uint fdwOpen);

I could only get this to work by changing the following:
Wave.WAVEFORMATEX pwfx  => ref WAVEFORMATEX pwfx  // reference pointer rather than the format struct.

I kept getting the System.NotSupportedException when I tried to follow the MSDN recommended approach of passing the struct to the waveOutOpen rather than the ref.  (If you downloaded the Pinvoke sample library, it was called WaveOut.cs located here: C:\Program Files\.NET Compact Framework Samples\PInvoke Library\Code\CS).  Going through their sample program, it looks like they read in the wav file, get the header information using a binary read, then pass the binary data to the waveOutOpen.  They never use the WAVEFORMATEX struct to open the wavOutOpen.

!!!!Sample Code:
		using System;
		using System.Data;
		using System.Runtime.InteropServices;
		namespace waveoutopen {
	class Tester
	{
		static void Main(string[] args)
		{
			Tester t = new Tester();
			t.Run();
		}
		public void Run()
		{
			WAVEFORMATEX testFormat = new WAVEFORMATEX();	
			testFormat.wFormatTag = 1;
			testFormat.wBitsPerSample = 16;   // 8,16
			testFormat.nChannels = 2;
			testFormat.nSamplesPerSec = 44100;
			testFormat.nBlockAlign = (ushort)(testFormat.nChannels *
				(testFormat.wBitsPerSample / 8));
			testFormat.nAvgBytesPerSec = (testFormat.nSamplesPerSec *
				testFormat.nBlockAlign);
			testFormat.cbSize = 0;

IntPtr m_hwi = IntPtr.Zero;
			IntPtr hwnd = IntPtr.Zero;

MMSYSERR result = waveOutOpen(ref m_hwi, WAVE_MAPPER, 
				ref testFormat, 0, 0, 0);

Console.WriteLine("and the result of open is {0}",result.ToString());
		}
		private const int MMSYSERR_BASE = 0;
		public const uint WAVE_MAPPER = unchecked((uint)(-1));
		public enum MMSYSERR : int
		{
			NOERROR = 0,
			ERROR = (MMSYSERR_BASE + 1),
			BADDEVICEID = (MMSYSERR_BASE + 2),
			NOTENABLED = (MMSYSERR_BASE + 3),
			ALLOCATED = (MMSYSERR_BASE + 4),
			INVALHANDLE = (MMSYSERR_BASE + 5),
			NODRIVER = (MMSYSERR_BASE + 6),
			NOMEM = (MMSYSERR_BASE + 7),
			NOTSUPPORTED = (MMSYSERR_BASE + 8),
			BADERRNUM = (MMSYSERR_BASE + 9),
			INVALFLAG = (MMSYSERR_BASE + 10),
			INVALPARAM = (MMSYSERR_BASE + 11),
			HANDLEBUSY = (MMSYSERR_BASE + 12),
			INVALIDALIAS = (MMSYSERR_BASE + 13),
			BADDB = (MMSYSERR_BASE + 14),
			KEYNOTFOUND = (MMSYSERR_BASE + 15),
			READERROR = (MMSYSERR_BASE + 16),
			WRITEERROR = (MMSYSERR_BASE + 17),
			DELETEERROR = (MMSYSERR_BASE + 18),
			VALNOTFOUND = (MMSYSERR_BASE + 19),
			NODRIVERCB = (MMSYSERR_BASE + 20),
			LASTERROR = (MMSYSERR_BASE + 20),
			BADFORMAT = (MMSYSERR_BASE + 32)
		}
		[DllImport ("coredll.dll")]
		private static extern MMSYSERR waveOutOpen(
			ref IntPtr phwo, 
			uint uDeviceID, 
			ref WAVEFORMATEX pwfx, 
			uint dwCallback, 
			uint dwInstance, 
			uint fdwOpen
			);
		[StructLayout(LayoutKind.Sequential)] 
		public unsafe struct WAVEFORMATEX
		{          
			public ushort wFormatTag;
			public ushort nChannels;
			public uint nSamplesPerSec;
			public uint nAvgBytesPerSec;
			public ushort nBlockAlign;
			public ushort wBitsPerSample;
			public ushort cbSize;	       
		}
	}
}
}

Documentation: waveOutOpen@msdn on MSDN