SetVPUPrintBufferSize

Fully qualified name: cupva::SetVPUPrintBufferSize

Defined in cupva_host_nonsafety.hpp

void cupva::SetVPUPrintBufferSize(uint32_t const size)

Set the size of VPU print buffer for the current context.

The actual size available may be more or less than requested as some driver versions will round the allocation to the next power of 2 then use some of the buffer for internal bookkeeping. This function should only be called when no stream in the current context contains pending commands. Even after waiting for all streams in the current context to become idle, this API can fail spuriously with cupva::Error::OperationPending, as the driver may still be cleaning up previous tasks. In this case, the operation should be retried.

If the size is set to 0, VPU print statements will not take effect.

This API is not available in safety builds.

Usage considerations

• Allowed context for the API call

  • Interrupt handler: No

  • Signal handler: No

  • Thread-safe: No

  • Re-entrant: No

  • Async/Sync: Sync

• Required privileges: None

• Allowed execution state

  • Initialization: Yes

  • Operational: No

  • Reinit/Deinit Preparation: Yes

• Maturity: GA

Parameters:

size – The requested VPU print buffer size. May not exceed config::MAX_VPU_PRINT_BUFFER_SIZE.

Throws:

• cupva::Exception(DriverAPIError) – or cupva::Exception(InvalidArgument) if the requested size is too large.

• cupva::Exception(OperationPending) – if the PVA driver is not yet idle

• cupva::Exception(NotAllowedInOperationalState) – if called when NVIDIA DRIVE OS VM state is “Operational”

Pre:

None