Home
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running QNX Neutrino 7.1.
Multimedia
Multimedia Renderer
Dictionary Object API
strm_dict_destroy()
Destroy a dictionary handle

QNX Momentics IDE User's Guide
This User's Guide describes version 7.1 of the Integrated Development Environment (IDE) that's part of the QNX Momentics tool suite.
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running QNX Neutrino 7.1.
- Quickstart Guide
- OS Components & Operations
- Audio & Graphics API
- Multimedia
  - Adding Multimedia to Target Images
  - Multimedia Renderer
    - Multimedia Renderer: Capabilities and Architecture
      The multimedia rendering service, mm-renderer, allows multimedia applications to play audio and video content from files and devices.
    - Configuring and Starting mm-renderer
      The multimedia renderer is a connection-based service that runs on the target system and allows media applications to control and monitor playback activity through API calls.
    - Playing and Recording Media Content
      The mm-renderer service lets you play audio and video tracks, and record audio content. You can select a file or streaming server as the input, and the appropriate hardware devices or rendering service for the outputs. During playback, mm-renderer manages the media flow based on commands.
    - Multimedia Renderer API
      The multimedia renderer API exposes the data types and functions you can use to connect to mm-renderer, create contexts, configure inputs and outputs, control playback, and process events.
    - Dictionary Object API
      - Function safety
        Function safety refers to whether or not it's safe to use the Dictionary Object API (libstrm library) functions in certain situations.
      - strm_dict_t
        Dictionary object
      - strm_dict_clone()
        Clone a dictionary handle
      - strm_dict_compare()
        Compare two dictionaries to find the added and modified entries
      - strm_dict_destroy()
        Destroy a dictionary handle
      - strm_dict_find_index()
        Get the index of a dictionary entry based on its key
      - strm_dict_find_rstr()
        Get the value of a dictionary entry as a shareable string, based on its key
      - strm_dict_find_value()
        Get the value of a dictionary entry as a string, based on its key
      - strm_dict_index_delete()
        Delete a dictionary entry by index
      - strm_dict_key_delete()
        Delete a dictionary entry by key
      - strm_dict_key_get()
        Get the key of a dictionary entry as a string, based on its index
      - strm_dict_key_rstr()
        Get the key of a dictionary entry as a shareable string, based on its index
      - strm_dict_new()
        Create a new dictionary handle to an empty dictionary
      - strm_dict_set()
        Add or modify a dictionary entry using strings
      - strm_dict_set_index()
        Modify a dictionary entry by index, using a string
      - strm_dict_set_index_rstr()
        Modify a dictionary entry by index, using a shareable string
      - strm_dict_set_rstr()
        Add or modify a dictionary entry using shareable strings
      - strm_dict_size()
        Get the number of entries in a dictionary
      - strm_dict_subtract()
        Subtract one dictionary from another
      - strm_dict_value_get()
        Get the value of a dictionary entry as a string, based on its index
      - strm_dict_value_rstr()
        Get the value of a dictionary entry as a shareable string, based on its index
      - strm_string_t
        Shareable string object
      - strm_string_alloc()
        Allocate a new shareable string
      - strm_string_clone()
        Clone a shareable string handle
      - strm_string_destroy()
        Destroy a shareable string handle
      - strm_string_get()
        Return a pointer to the string in a shareable string
      - strm_string_make()
        Create a new shareable string containing a copy of the provided string
      - strm_string_modify()
        Modify the string stored in a shareable string
  - Multimedia Streaming Server
  - Multimedia Test Utilities
  - OpenMAX AL Additions
- Networking Middleware
- Programming
- Sensor Framework
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX Neutrino RTOS system and developers who want to create a QNX Neutrino resource manager free from vulnerabilities.
- Utilities & Libraries
QNX Hypervisor
The QNX Hypervisor allows you to run multiple OSs on a target system so you can separate critical and non-critical functions, support a wide variety of applications, and reduce hardware costs.
QNX Software in the Cloud
QNX Software in the Cloud enables developers to use the QNX software in Amazon Web Services (AWS) and Microsoft Azure (Azure).
QNX Advanced Virtualization Frameworks User's Guide
This User's Guide is aimed at all systems integrators and developers who want to design and build embedded systems using the QNX Advanced Virtualization Frameworks.
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation and explains how to obtain technical support.

strm_dict_destroy()

Destroy a dictionary handle

Synopsis:

#include <sys/strm.h>

int strm_dict_destroy(strm_dict_t *dict)

Arguments:

dict: A dictionary handle.

Library:

libstrm

Description:

This function destroys the specified dictionary handle and if this is the last handle, frees the memory allocated for the dictionary object.

Returns:

Zero on success, -1 on failure (check errno).

Page updated: March 12, 2026