staticSafetyId | The static safety ID with which the provided custom error message should be associated. This ID must have been allocated with NewStaticSafetyId. Passing 0 is invalid; this is the default static safety ID, and its error messages can not be modified. |
errorType | The class of error that should use the provided custom error message instead of the default job debugger error message. |
messageBytes | The error message to use for the specified error type. This is expected to be a UTF8-encoded byte array, and is not required to be null-terminated. |
byteCount | The number of bytes in the messageBytes array, excluding the optional null terminator. |
Provide a custom error message for a specific job debugger error type, in cases where additional context can be provided.
The job debugger looks up error messages for AtomicSafetyHandles using the specified static safety ID and error type. You should provide a message for each applicable type of error defined in AtomicSafetyErrorType. Without a specific error message, the job debugger can only emit general error messages that may not clearly identify the source of the error.
If the message contains any of the following sequences, they will be replaced with the corresponding context-specific data (if available) when the message is emitted:
- {2} = this job name. example: "BoidsJob"
- {3} = this job field. example: "BoidsJob.boidsBuffer"
- {5} = this owner type. example: "NativeArray<int>"