<trclass="memdesc:gae86a5acb1b22b61bc9ecb9c28fc71b75"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Create an event with the specified flags. <ahref="#gae86a5acb1b22b61bc9ecb9c28fc71b75">More...</a><br/></td></tr>
<trclass="memdesc:ga553b6f7a8e7b7dd9536d8a64c24d7e29"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Record an event in the specified stream. <ahref="#ga553b6f7a8e7b7dd9536d8a64c24d7e29">More...</a><br/></td></tr>
<trclass="memdesc:ga83260357dce0c39e8c6a3c74ec97484c"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Destroy the specified event. <ahref="#ga83260357dce0c39e8c6a3c74ec97484c">More...</a><br/></td></tr>
<trclass="memdesc:ga1f72d98ba5d6f7dc3da54e0c41fe38b1"><tdclass="mdescLeft"> </td><tdclass="mdescRight">: Wait for an event to complete. <ahref="#ga1f72d98ba5d6f7dc3da54e0c41fe38b1">More...</a><br/></td></tr>
<trclass="memdesc:gad4128b815cb475c8e13c7e66ff6250b7"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Return the elapsed time between two events. <ahref="#gad4128b815cb475c8e13c7e66ff6250b7">More...</a><br/></td></tr>
<tr><tdclass="paramdir">[in,out]</td><tdclass="paramname">event</td><td>Returns the newly created event. </td></tr>
<tr><tdclass="paramdir">[in]</td><tdclass="paramname">flags</td><td>Flags to control event behavior. <aclass="el"href="group__GlobalDefs.html#ga122a5853359eba97cf047ddd153740f0"title="Flags that can be used with hipEventCreateWithFlags: ">hipEventDefault</a>, <aclass="el"href="group__GlobalDefs.html#gafa1c076a5b991763a98695063f1ea11d"title="Waiting will yield CPU. Power-friendly and usage-friendly but may increase latency. ">hipEventBlockingSync</a>, <aclass="el"href="group__GlobalDefs.html#ga3c0f44a85e36a4c67671da6bcdad0351"title="Disable event's capability to record timing information. May improve performance. ...">hipEventDisableTiming</a>, <aclass="el"href="group__GlobalDefs.html#ga0f01d74059baa704e42aeff8222166bb"title="Event can support IPC. ">hipEventInterprocess</a></td></tr>
</table>
</dd>
</dl>
<dlclass="section warning"><dt>Warning</dt><dd>On HCC platform, <aclass="el"href="group__GlobalDefs.html#ga0f01d74059baa704e42aeff8222166bb"title="Event can support IPC. ">hipEventInterprocess</a> is not supported.</dd></dl>
<p>Releases memory associated with the event. If the event is recording but has not completed recording when hipEventDestroy is called, the function will return immediately and the completion_future resources will be released later, when the hipDevice is synchronized. </p>
<dlclass="section return"><dt>Returns</dt><dd>: <aclass="el"href="group__GlobalDefs.html#ggadf5010f6e140a53ecbdf949e73e87594aadfbdb847b149723c684ebd764556063"title="Successful completion. ">hipSuccess</a>, <aclass="el"href="group__GlobalDefs.html#ggadf5010f6e140a53ecbdf949e73e87594a88e525a7c8f35552dfada58e9f2f6d3a"title="Resource handle (hipEvent_t or hipStream_t) invalid. ">hipErrorInvalidResourceHandle</a>, <aclass="el"href="group__GlobalDefs.html#ggadf5010f6e140a53ecbdf949e73e87594aa9638063c8746a9d1fda2b2069a0a9f1"title="Indicates that asynchronous operations enqueued earlier are not ready. This is not actually an error...">hipErrorNotReady</a>,</dd></dl>
<p>Computes the elapsed time between two events. Time is computed in ms, with a resolution of approximately 1 us.</p>
<p>Events which are recorded in a NULL stream will block until all commands on all other streams complete execution, and then record the timestamp.</p>
<p>Events which are recorded in a non-NULL stream will record their timestamp when they reach the head of the specified stream, after all previous commands in that stream have completed executing. Thus the time that the event recorded may be significantly after the host calls hipEventRecord.</p>
<p>If hipEventRecord has not been called on either event, then <aclass="el"href="group__GlobalDefs.html#ggadf5010f6e140a53ecbdf949e73e87594a88e525a7c8f35552dfada58e9f2f6d3a"title="Resource handle (hipEvent_t or hipStream_t) invalid. ">hipErrorInvalidResourceHandle</a> is returned. If hipEventRecord has been called on both events, but the timestamp has not yet been recorded on one or both events (that is, hipEventQuery would return <aclass="el"href="group__GlobalDefs.html#ggadf5010f6e140a53ecbdf949e73e87594aa9638063c8746a9d1fda2b2069a0a9f1"title="Indicates that asynchronous operations enqueued earlier are not ready. This is not actually an error...">hipErrorNotReady</a> on at least one of the events), then <aclass="el"href="group__GlobalDefs.html#ggadf5010f6e140a53ecbdf949e73e87594aa9638063c8746a9d1fda2b2069a0a9f1"title="Indicates that asynchronous operations enqueued earlier are not ready. This is not actually an error...">hipErrorNotReady</a> is returned. </p>
<p>Query the status of the specified event. This function will return <aclass="el"href="group__GlobalDefs.html#ggadf5010f6e140a53ecbdf949e73e87594aa9638063c8746a9d1fda2b2069a0a9f1"title="Indicates that asynchronous operations enqueued earlier are not ready. This is not actually an error...">hipErrorNotReady</a> if all commands in the appropriate stream (specified to hipEventRecord) have completed. If that work has not completed, or if hipEventRecord was not called on the event, then hipSuccess is returned. </p>
<p>hipEventQuery or hipEventSynchronize must be used to determine when the event transitions from "recording" (after eventRecord is called) to "recorded" (when timestamps are set, if requested).</p>
<p>Events which are recorded in a non-NULL stream will transition to from recording to "recorded" state when they reach the head of the specified stream, after all previous commands in that stream have completed executing.</p>
<p>If hipEventRecord has been previously called aon event, then this call will overwrite any existing state in event.</p>
<p>If this function is called on a an event that is currently being recorded, results are undefined - either outstanding recording may save state into the event, and the order is not guaranteed. This shoul be avoided.</p>
<dlclass="section see"><dt>See Also</dt><dd><aclass="el"href="group__Event.html#gad4128b815cb475c8e13c7e66ff6250b7"title="Return the elapsed time between two events. ">hipEventElapsedTime</a></dd></dl>
<p>This function will block until the event is ready, waiting for all previous work in the stream specified when event was recorded with hipEventRecord.</p>
<p>If hipEventRecord has not been called on <code>event</code>, this function returns immediately.</p>
<p>TODO-hcc - This function needs to support hipEventBlockingSync parameter.</p>
<dlclass="params"><dt>Parameters</dt><dd>
<tableclass="params">
<tr><tdclass="paramdir">[in]</td><tdclass="paramname">event</td><td>Event on which to wait. </td></tr>
