@@ -1108,20 +1108,28 @@ they do in non-recording mode.
1108
1108
1109
1109
==== Event Limitations
1110
1110
1111
- Events returned from queue submissions when a queue is in the recording state
1112
- may only be used as parameters to `handler::depends_on()` or as dependent
1113
- events for queue shortcuts like `queue::parallel_for()` for submissions which
1114
- are being recorded to the same modifiable `command_graph`.
1111
+ For queue submissions that are being recorded to a modifiable `command_graph`,
1112
+ the only events that can be used as parameters to `handler::depends_on()`, or
1113
+ as dependent events for queue shortcuts like `queue::parallel_for()`, are events
1114
+ that have been returned from queue submissions recorded to the same modifiable
1115
+ `command_graph`.
1116
+
1117
+ Other limitations on the events returned from a submission to a queue in the
1118
+ recording state are:
1115
1119
1116
1120
- Calling `event::get_info<info::event::command_execution_status>()` or
1117
- `event::get_profiling_info()` on an event returned from a queue submission
1118
- recorded to a graph will throw synchronously with error code `invalid`.
1121
+ `event::get_profiling_info()` will throw synchronously with error code `invalid`.
1122
+
1123
+ - A host-side wait on the event will throw synchronously with error
1124
+ code `invalid`.
1125
+
1126
+ - Using the event outside of the recording scope will throw synchronously with error code
1127
+ `invalid`.
1119
1128
1120
- - Waiting on an event returned from a queue submission recorded to a graph
1121
- will throw synchronously with error code `invalid`.
1129
+ ==== Queue Limitations
1122
1130
1123
- - Waiting on a queue in the recording state is an error and will throw
1124
- synchronously with error code `invalid`.
1131
+ A host-side wait on a queue in the recording state is an error and will
1132
+ throw synchronously with error code `invalid`.
1125
1133
1126
1134
==== Buffer Limitations
1127
1135
0 commit comments