GetStatus

Fully qualified name: cupva::GetStatus

Defined in src/host/shared/include/install/cupva_host_common.hpp

Status cupva::GetStatus()

Return the health of the current Context.

Once an asynchronous error has occurred, the associated Context becomes invalid and the Streams that belong to the Context will fail to submit new Commands. This reports whether the current Context is still valid, and describes the source of the failure when it is not.

For a quick validity check, test the returned err against cupva::Error::None. The remaining fields describe where the failure came from; see cupva::Status.

Once a user created Context becomes invalid, the application has a chance to recover by tearing down all the resources owned by the Context, destroying the Context, and then starting over with a freshly created Context. The default Context owned by cuPVA is not recoverable in this way. Once the default Context becomes invalid, the process must exit and restart to establish a valid default Context.

The errorMsg and streamName members remain valid for the life of the Context they describe.

Usage considerations

• Allowed context for the API call

  • Interrupt handler: No

  • Signal handler: No

  • Thread-safe: Yes

  • Re-entrant: No

  • Async/Sync: Sync

• Required privileges: None

• Allowed execution state

  • Initialization: Yes

  • Operational: Yes

  • Reinit/Deinit Preparation: Yes

• Maturity: GA

Throws:

• cupva::Exception(InsufficientDriverVersion) – if the driver does not support Context error reporting.

• cupva::Exception(DriverAPIError) – if querying the driver fails.

Returns:

The health of the current Context.

Pre:

None