Function rmw_client_request_publisher_get_actual_qos

Function Documentation

rmw_ret_t rmw_client_request_publisher_get_actual_qos(const rmw_client_t *client, rmw_qos_profile_t *qos)

Retrieve the actual qos settings of the client’s request publisher.

Query the underlying middleware to determine the qos settings of the client’s request publisher. The actual configuration applied when using RMW_*_SYSTEM_DEFAULT can only be resolved after the creation of the client, and it depends on the underlying rmw implementation. If the underlying setting in use can’t be represented in ROS terms, it will be set to RMW_*_UNKNOWN.

Attribute

Adherence

Allocates Memory

Maybe [1]

Thread-Safe

No

Uses Atomics

Maybe [1]

Lock-Free

Maybe [1]

[1] rmw implementation defined, check the implementation documentation

Note

The value of avoid_ros_namespace_conventions field is not resolved with this function. The rcl function rcl_client_request_publisher_get_actual_qos() resolves it.

Parameters:
  • client[in] the client object to inspect

  • qos[out] the actual qos settings

Returns:

RMW_RET_OK if successful, or

Returns:

RMW_RET_INVALID_ARGUMENT if either argument is null, or

Returns:

RMW_RET_INCORRECT_RMW_IMPLEMENTATION if client implementation identifier does not match, or

Returns:

RMW_RET_ERROR if an unexpected error occurs.