Submits a user-defined function to be executed on the stream. More...
Typedefs | |
typedef void(* | VPIHostFunction) (void *hostData) |
Pointer to a host function. More... | |
typedef VPIStatus(* | VPIHostFunctionEx) (VPIStream stream, VPIStatus status, void *hostData) |
Pointer to a host function that handles stream status. More... | |
Functions | |
VPIStatus | vpiSubmitHostFunction (VPIStream stream, VPIHostFunction hostFunc, void *hostData) |
Pushes a command that will invoke a custom host-side function after all prior commands have been processed. More... | |
VPIStatus | vpiSubmitHostFunctionEx (VPIStream stream, VPIHostFunctionEx hostFunc, void *hostData) |
Pushes a command that will invoke a custom host-side function after all prior commands have been processed. More... | |
Submits a user-defined function to be executed on the stream.
typedef void(* VPIHostFunction) (void *hostData) |
#include <vpi/HostFunction.h>
Pointer to a host function.
[in] | hostData | callback data |
Definition at line 81 of file HostFunction.h.
#include <vpi/HostFunction.h>
Pointer to a host function that handles stream status.
[in] | stream | Stream that is executing the host function. |
[in] | status | Status of the last operation executed by the stream. |
[in] | hostData | Callback data associated with this call. |
Definition at line 107 of file HostFunction.h.
VPIStatus vpiSubmitHostFunction | ( | VPIStream | stream, |
VPIHostFunction | hostFunc, | ||
void * | hostData | ||
) |
#include <vpi/HostFunction.h>
Pushes a command that will invoke a custom host-side function after all prior commands have been processed.
The execution of commands submitted after this call is suspended until the callback is finished. The function will be executed at most once. It won't be executed if a previous stream task failed.
This operation will implicitly flush the stream.
[in] | stream | Stream that will execute the host function call. |
[in] | hostFunc | Host function to be executed. |
[in] | hostData | pointer that will be passed unchanged to the user function |
VPIStatus vpiSubmitHostFunctionEx | ( | VPIStream | stream, |
VPIHostFunctionEx | hostFunc, | ||
void * | hostData | ||
) |
#include <vpi/HostFunction.h>
Pushes a command that will invoke a custom host-side function after all prior commands have been processed.
The execution of commands submitted after this call is suspended until the callback is finished. The function is guaranteed to be executed exactly once. In case the stream is in error state, the corresponding error status will be passed to hostFunc. The error state can either be maintained by returning the same status, changed to another status, or, if returning VPI_SUCCESS, the error state will be reset.
This operation will implicitly flush the stream.
[in] | stream | Stream that will execute the host function call. |
[in] | hostFunc | Host function to be executed. |
[in] | hostData | Pointer that will be passed unchanged to the user function |