Method Start

PerformanceMonitor/DebugMonitor.cs:167–230

Starts this debug monitor

()

		/// Starts this debug monitor
		/// </summary>
		public static void Start() {
			lock (m_SyncRoot) {
				if (m_Capturer != null)
					throw new ApplicationException("This DebugMonitor is already started.");

				// Check for supported operating system. Mono (at least with *nix) won't support
				// our P/Invoke calls.
				if (Environment.OSVersion.ToString().IndexOf("Microsoft") == -1)
					throw new NotSupportedException("This DebugMonitor is only supported on Microsoft operating systems.");

				// Check for multiple instances. As the README.TXT of the msdn 
				// example notes it is possible to have multiple debug monitors
				// listen on OutputDebugString, but the message will be randomly
				// distributed among all running instances so this won't be
				// such a good idea.				
				bool createdNew = false;
				m_Mutex = new Mutex(false, typeof(DebugMonitor).Namespace, out createdNew);				
				if (!createdNew)
					throw new ApplicationException("There is already an instance of 'DbMon.NET' running.");									

				SECURITY_DESCRIPTOR sd = new SECURITY_DESCRIPTOR();
			
				// Initialize the security descriptor.
				if (!InitializeSecurityDescriptor(ref sd, SECURITY_DESCRIPTOR_REVISION)) {
					throw CreateApplicationException("Failed to initializes the security descriptor.");
				}

				// Set information in a discretionary access control list
				if (!SetSecurityDescriptorDacl(ref sd, true, IntPtr.Zero, false)) {
					throw CreateApplicationException("Failed to initializes the security descriptor");
				}
			
				SECURITY_ATTRIBUTES sa = new SECURITY_ATTRIBUTES();

				// Create the event for slot 'DBWIN_BUFFER_READY'
				m_AckEvent = CreateEvent(ref sa, false, false, "DBWIN_BUFFER_READY");
				if (m_AckEvent == IntPtr.Zero) {
					throw CreateApplicationException("Failed to create event 'DBWIN_BUFFER_READY'");
				}

				// Create the event for slot 'DBWIN_DATA_READY'
				m_ReadyEvent = CreateEvent(ref sa, false, false, "DBWIN_DATA_READY");
				if (m_ReadyEvent == IntPtr.Zero) {
					throw CreateApplicationException("Failed to create event 'DBWIN_DATA_READY'");
				}
			
				// Get a handle to the readable shared memory at slot 'DBWIN_BUFFER'.
				m_SharedFile = CreateFileMapping(new IntPtr(-1), ref sa, PageProtection.ReadWrite, 0, 4096, "DBWIN_BUFFER");
				if (m_SharedFile == IntPtr.Zero) {
					throw CreateApplicationException("Failed to create a file mapping to slot 'DBWIN_BUFFER'");
				}

				// Create a view for this file mapping so we can access it
				m_SharedMem = MapViewOfFile(m_SharedFile, SECTION_MAP_READ, 0, 0, 512);
				if (m_SharedMem == IntPtr.Zero) {
					throw CreateApplicationException("Failed to create a mapping view for slot 'DBWIN_BUFFER'");
				}