Function QnnSignal_trigger

Function Documentation

Qnn_ErrorHandle_t QnnSignal_trigger(Qnn_SignalHandle_t signal)

Triggers the signal action during the associated API call. For abort config signals, it causes the associated API call to gracefully cease execution at the earliest opportunity. This function will block until the targeted call has released associated resources and is ready to return in it’s own calling context. When the associated API call is initiated, the signal object will be in-use and not available to another call. When the associated API call returns, the associated signal object will be available and can safely be passed to another call.

Parameters

signal – [in] Signal handle used by the associated API call

Returns

Error code:

  • QNN_SUCCESS: if the trigger is successful.

  • QNN_SIGNAL_ERROR_INVALID_HANDLE: signal handle is null or invalid

  • QNN_SIGNAL_ERROR_INCOMPATIBLE_SIGNAL_TYPE: API does not support the signal type

  • QNN_SIGNAL_ERROR_TRIGGER_SIGNAL_IDLE: if the signal is not currently in-use, and hence can not be triggered.

  • QNN_SIGNAL_ERROR_UNSUPPORTED: if QnnSignal API is not supported on the backend

  • QNN_COMMON_ERROR_SYSTEM_COMMUNICATION: SSR occurence (successful recovery)

  • QNN_COMMON_ERROR_SYSTEM_COMMUNICATION_FATAL: SSR occurence (unsuccessful recovery)