struct in Unity.Collections.LowLevel.Unsafe
/
Implemented in:UnityEngine.CoreModule
Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.
CloseFor some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.
CloseAtomicSafetyHandle is used by the job system to coordinate access to container memory from multiple jobs safely.
You typically do not need to use this type in your code unless you are implementing your own NativeContainer type. For a conceptual overview of AtomicSafetyHandle and the role it plays in the job system, see Implement a custom native container.
CheckDeallocateAndThrow | Checks if the handle can be deallocated. Throws an exception if it has already been destroyed or a job is currently accessing the data. |
CheckExistsAndThrow | Checks if the handle is still valid and throws an exception if it is already destroyed. |
CheckGetSecondaryDataPointerAndThrow | Check if the data pointer is in a valid state to be aliased by a view on the container which will use the secondary version number. |
CheckReadAndThrow | Checks if the handle can be read from. Throws an exception if already destroyed or a job is currently writing to the data. |
CheckWriteAndBumpSecondaryVersion | Performs AtomicSafetyHandle.CheckWriteAndThrow and then, assuming that the handle can be written to, bumps the secondary version. |
CheckWriteAndThrow | Checks if the handle can be written to. Throws an exception if already destroyed or a job is currently reading or writing to the data. |
Create | Creates a new AtomicSafetyHandle. |
EnforceAllBufferJobsHaveCompleted | Waits for all jobs running against this AtomicSafetyHandle to complete. |
EnforceAllBufferJobsHaveCompletedAndDisableReadWrite | Waits for all jobs running against this AtomicSafetyHandle to complete and then disables the read and write access on this atomic safety handle. |
EnforceAllBufferJobsHaveCompletedAndRelease | Waits for all jobs running against this AtomicSafetyHandle to complete and then releases the atomic safety handle. |
GetAllowReadOrWriteAccess | Returns true if the AtomicSafetyHandle is configured to allow reading or writing. |
GetNestedContainer | Check whether the given AtomicSafetyHandle represents a nested container, and therefore cannot safely be used in jobs. |
GetReaderArray | Fetch the job handles of all jobs reading from the safety handle. |
GetReaderName | Return the name of the specified reading job. |
GetTempMemoryHandle | Returns the safety handle which should be used for all temp memory allocations in this temp memory scope. |
GetTempUnsafePtrSliceHandle | Returns a single shared handle, that can be shared by for example NativeSlice pointing to stack memory. |
GetWriter | Return the writer (if any) on an atomic safety handle. |
GetWriterName | Return the debug name of the current writer on an atomic safety handle. |
IsDefaultValue | Check if the handle still has its default value (i.e. has not yet been initialized by being assigned or passed to AtomicSafetyHandle.Create). |
IsHandleValid | Check if the AtomicSafetyHandle is still valid. |
IsTempMemoryHandle | Checks if an AtomicSafetyHandle is the temp memory safety handle for the currently active temp memory scope. |
IsValidNonDefaultHandle | Check if the handle has been initialized and is currently valid. |
NewStaticSafetyId | Allocates a new static safety ID, to store information for the provided type T. |
PrepareUndisposable | Marks the AtomicSafetyHandle so that it cannot be disposed of. |
Release | Releases a previously created AtomicSafetyHandle. |
SetAllowReadOrWriteAccess | Lets you prevent read or write access on the atomic safety handle. |
SetAllowSecondaryVersionWriting | Set whether handles which use the secondary version number are allowed to write to the container protected by this handle. |
SetBumpSecondaryVersionOnScheduleWrite | Lets you automatically bump the secondary version when scheduling a job that has write access to the atomic safety handle. |
SetCustomErrorMessage | Provide a custom error message for a specific job debugger error type, in cases where additional context can be provided. |
SetNestedContainer | Sets or unsets the nested container flag on an AtomicSafetyHandle. |
SetStaticSafetyId | Assigns the provided static safety ID to an AtomicSafetyHandle. The ID's owner type name and any custom error messages are used by the job debugger when reporting errors involving the target handle. |
UseSecondaryVersion | Switches the AtomicSafetyHandle to the secondary version number. |
ValidateNonDefaultHandle | Check that the handle has been initialized, and if so, check that it is still valid. |
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.