overlappedFreeError MDA
Note
This article is specific to .NET Framework. It doesn't apply to newer implementations of .NET, including .NET 6 and later versions.
The overlappedFreeError managed debugging assistant (MDA) is activated when the Overlapped.Free(NativeOverlapped*) method is called before the overlapped operation has completed.
Symptoms
Access violations or corruption of the garbage-collected heap.
Cause
An overlapped structure was freed before the operation completed. The function that is using the overlapped pointer might write to the structure later, after it has been freed. That can cause heap corruption because another object might now occupy that region.
This MDA might not represent an error if the overlapped operation did not start successfully.
Resolution
Ensure that the I/O operation using the overlapped structure has completed before calling the Free(NativeOverlapped*) method.
Effect on the Runtime
This MDA has no effect on the CLR.
Output
The following is sample output for this MDA.
An overlapped pointer (0x00ea3430) that was not allocated on the GC heap was passed via Pinvoke to the win32 function 'WriteFile' in module 'KERNEL32.DLL'. If the AppDomain is shut down, this can cause heap corruption when the async I/O completes. The best solution is to pass a NativeOverlappedStructure retrieved from a call to System.Threading.Overlapped.Pack(). If the AppDomain exits, the CLR will keep this structure alive and pinned until the I/O completes.
Configuration
<mdaConfig>
<assistants>
<overlappedFreeError/>
</assistants>
</mdaConfig>
