Wait Synchronization Technology Sample
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
This sample demonstrates how to use the WaitHandle class for thread synchronization. The WaitHandle-derived type Mutex is used to enforce mutually exclusive access to a protected block of code.
For more information about using the samples, see the following topics:
To build the sample using the command prompt
Open the Command Prompt window and navigate to one of the language-specific subdirectories for the sample.
Type msbuild WaitSynchronizationCS.sln or msbuild WaitSynchronizationVB.sln, depending on your choice of programming language, at the command line.
To build the sample using Visual Studio
Open Windows Explorer and navigate to one of the language-specific subdirectories for the sample.
Double-click the icon for WaitSynchronizationCS.sln or WaitSynchronizationVB.sln, depending on your choice of programming language, to open the file in Visual Studio.
On the Build menu, click Build Solution.
To run the sample
Navigate to the directory that contains the new executable file.
Type Mutex.exe from the command line.
Note
This sample builds a console application. You must launch it from a console window to view its output.
Remarks
This sample queues up five asynchronous method calls. Each method then waits to own the resource, writes to the console, sleeps, and then writes to the console a second time.
The following bullets briefly describe the technologies and classes used by this sample:
Thread Synchronization
Mutex Provides mutual exclusion for thread synchronization.
AutoResetEvent The sample's main thread waits on an AutoResetEvent until it is set. This indicates that the last of the asynchronous functions are finished doing their work.
WaitHandle The WaitHandle class is the base class from which both Mutex and AutoResetEvent classes (among others) are derived. This type implements methods to "wait" for the various derived types to go "signaled".
Interlocked The sample uses the static Decrement method to access a counter variable asynchronously to indicate when the AutoResetEvent should be set.
Threading
- ThreadPool When writing managed code, it is suggested that, whenever possible, developers use the QueueUserWorkItem method to implement asynchronous method calls. This sample uses this approach to execute code that contends for a logical resource.
Delegates
- WaitCallback Used to create a type-safe callback method for the ThreadPool class to use.
For more information about threading and synchronization, see the comments in the source code and build.proj files.