Thread Data Sharing Events Window

Display information on data shared by threads.

Toolbar

Thread Data Sharing Events

Thread data sharing analyses are displayed as follows:

Analysis run from date_and_time, (number_of_events, state[, break_state][, filters])
     object_with_shared_access, number_of_accesses
        access_location_1 
        access_location_2 
        (...)
     (...)

The first level displays the analysis runs. It is created for each debugger run when the analysis is enabled. It provides the history of multiple analysis runs with the following parameters:

Parameter	Value/Description
`date`	The date and time of the analysis run.
`events`	The number of detected thread data sharing events.
`state`	`enabled` The analysis is active. Thread data sharing events are being detected. `disabled` The analysis was disabled by user-input. `completed` Old analysis run. `initializing...` The analysis is being initialized. After successful initialization, the analysis state is set to enabled and thread data sharing events are being detected.
`break_state`	This parameter is only displayed when the analysis is enabled. `break` Stop on event is enabled. The debugger stops the application when a thread data sharing event is detected. continue `continue` Stop on event is disabled. The debugger does not stop the application when a thread data sharing event is detected. See also Detecting Thread Data Sharing Events.
`filters`	This parameter is only displayed when the analysis is enabled. The number of active filters. See also Thread Data Sharing Filters Window.

The second level displays objects shared by threads. It contains an object's address in numeric and symbolic format and the number of recorded accesses.

The third level shows the locations of individual accesses to the object. There are always two or more locations. The location information includes the source position and numeric address, indicates read or write access, and provides the OS thread-id.

Note

Events are never combined within the same address.
The events are displayed in the order in which they occurred. There are no sorting options.
You cannot filter events that are already displayed in the window.

The status bar of the Thread Data Sharing Events window displays the status of the current analysis (active or disabled), the filterset used with this analysis and the number of currently active filters. It also displays errors with the current analysis.

Example (C++)

Pop-up Menu

The specified filter is added to the Thread Data Sharing Filters window. The Thread Data Sharing Events window displays the number of active filters for the current analysis run.

Enable Detection

Enables the thread data sharing detection. Must be enabled before the program enters the parallel region you want to debug.

Stop on Event

Automatically stops the program execution when a thread data sharing event is detected. This feature is active by default. The Thread Data Sharing Events window displays break when this feature is enabled, and continue, when it is disabled.

Reset Current Detection

Clears all event history from the runtime library. This means, the detection is started over from the beginning and all previous access history is lost. This is useful, when you disabled data sharing detection and want to reenable it later. Otherwise, accesses from the previous parallel region will be considered as well.

Export Events

Writes the event history data to an external text file. The data is stored in a table format.

Delete

Removes the selected analysis from the Thread Data Sharing Events window.

Delete All

Removes all analysis runs from the Thread Data Sharing Events window.

Go To

Jumps to a specific window. You can choose one of the following options:

Source Code	Displays the source code that generated the selected event.
Disassembly	Displays the disassembly code that generated the selected event.
Filters	Opens the Thread Data Sharing Filters window where you can view, modify and add filters to exclude items from further detection.

Suppress Reporting of Future Accesses

Filters the thread data sharing analysis for different access types to exclude them from further detection. You can choose one of the following access types:

From this Access

Filters thread data sharing detection for the access that generated the selected event.

From this Function

Filters all thread data sharing detections for the function that generated the selected event.

From this Source File

Filters all thread data sharing detections for the source file that generated the selected event.

From this Source Line

Filters all thread data sharing detections for the source line that generated the selected event.

To this Data Object

Filters all thread data sharing detections for the data object that generated the selected event.

Show Events Window Automatically

Automatically opens the Thread Data Sharing Events window when the thread data sharing detection is enabled or when you enabled Stop on Event and a new event occurs. This functionality remains enabled until you disable it manually, this means once you set the option, it will be restored at any restart of Microsoft Visual Studio*.

Thread Data Sharing Events Window

Menu

Toolbar

Note

Example (C++)

Pop-up Menu

See Also