HP-UX Multimedia Streaming Protocols (MSP) Programmer's Guide

The following describes the RTSP connection APIs:
• rtsp_open
To create a new RTSP connection, use rtsp_open.
The declaration of rtsp_open is as follows:
#include <rtsp.h>
rtsp_error_t rtsp_open(
rtsp_url_t *rtspurl,
rtsp_flags_t flags,
rtsp_conn_t **conn
);
The rtsp_open function dynamically allocates memory for a new rtsp_conn_t
structure and opens a transport connection to the peer. The rtspurl argument must
point to the rtsp_urt_t structure, which contains the peer information. The
address of the new rtsp_conn_t structure is returned in the location pointed by
the conn argument. You must initialize the location pointed to by the conn
argument to NULL before calling the function.
You must pass the following arguments to rtsp_open:
— rtspurl - Pointer to the rtsp_url_t structure.
— flags - RTSP connection flags set by means of a bitwise OR operation. Currently,
the rtsp.h file contains the declaration of only one connection flag,
RTSP_CFLAG_CS.
— conn - Pointer where the location for the new RTSP connection is returned.
Upon success, the rtsp_open API returns RTSP_SUCCESS, and the pointer to
the new rtsp_conn_t structure is returned in the location pointed to by the conn
argument. Upon failure, rtsp_open returns one of the following error values:
— RTSP_EINVAL
◦ The rtspurl argument is NULL.
◦ The conn argument is NULL.
◦ The location pointed to by the conn argument is not NULL.
◦ The flags argument contains an invalid value.
— RTSP_ENOMEM
Dynamic memory allocation failure.
32 Using MSP APIs