开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
QTStreamingComponents.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：72k
源码类别：

多媒体编程

开发平台：

Visual C++

QTStreamingComponents.h：源码内容
  1. /*
  2.      File:       QTStreamingComponents.h
  3.  
  4.      Contains:   QuickTime Interfaces.
  5.  
  6.      Version:    Technology: QuickTime 6.0
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1990-2001 by Apple Computer, Inc., all rights reserved
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __QTSTREAMINGCOMPONENTS__
  18. #define __QTSTREAMINGCOMPONENTS__
  20. #ifndef __COMPONENTS__
  21. #include "Components.h"
  22. #endif
  24. #ifndef __MACERRORS__
  25. #include "MacErrors.h"
  26. #endif
  28. #ifndef __MOVIES__
  29. #include "Movies.h"
  30. #endif
  32. #ifndef __QUICKTIMESTREAMING__
  33. #include "QuickTimeStreaming.h"
  34. #endif
  39. #if PRAGMA_ONCE
  40. #pragma once
  41. #endif
  43. #ifdef __cplusplus
  44. extern "C" {
  45. #endif
  47. #if PRAGMA_IMPORT
  48. #pragma import on
  49. #endif
  51. #if PRAGMA_STRUCT_ALIGN
  52.     #pragma options align=mac68k
  53. #elif PRAGMA_STRUCT_PACKPUSH
  54.     #pragma pack(push, 2)
  55. #elif PRAGMA_STRUCT_PACK
  56.     #pragma pack(2)
  57. #endif
  59. /*============================================================================
  60.         Stream Sourcer
  61. ============================================================================*/
  62. enum {
  63.     kQTSSourcerType             = FOUR_CHAR_CODE('srcr')
  64. };
  66. typedef ComponentInstance               QTSSourcer;
  67. enum {
  68.     kQTSSGChannelSourcerType    = FOUR_CHAR_CODE('sgch'),
  69.     kQTSMovieTrackSourcerType   = FOUR_CHAR_CODE('trak'),
  70.     kQTSPushDataSourcerType     = FOUR_CHAR_CODE('push')
  71. };
  73. /* flags for sourcer data */
  74. enum {
  75.     kQTSSourcerDataFlag_SyncSample = 0x00000001,
  76.     kQTSPushDataSourcerFlag_SampleTimeIsValid = (long)0x80000000
  77. };
  80. enum {
  81.     kQTSSourcerInitParamsVersion1 = 1
  82. };
  85. struct QTSSourcerInitParams {
  86.     SInt32                          version;
  87.     SInt32                          flags;
  88.     OSType                          dataType;
  89.     void *                          data;
  90.     UInt32                          dataLength;
  91. };
  92. typedef struct QTSSourcerInitParams     QTSSourcerInitParams;
  93. EXTERN_API_C( OSErr )
  94. QTSNewSourcer                   (void *                 params,
  95.                                  const QTSSourcerInitParams * inInitParams,
  96.                                  SInt32                 inFlags,
  97.                                  ComponentInstance *    outSourcer);
  99. /* info selectors for sourcers - get and set */
  100. enum {
  101.     kQTSInfo_Track              = FOUR_CHAR_CODE('trak'),       /* QTSTrackParams* */
  102.     kQTSInfo_Loop               = FOUR_CHAR_CODE('loop'),       /* QTSLoopParams* */
  103.     kQTSInfo_SourcerTiming      = FOUR_CHAR_CODE('stim'),       /* QTSSourcerTimingParams* */
  104.     kQTSInfo_TargetFrameRate    = FOUR_CHAR_CODE('tfps'),       /* Fixed * in frames per second */
  105.     kQTSInfo_PushData           = FOUR_CHAR_CODE('push'),       /* QTSPushDataParams* */
  106.     kQTSInfo_SourcerCallbackProc = FOUR_CHAR_CODE('scbp'),      /* QTSSourcerCallbackProcParams* */
  107.     kQTSInfo_TargetDataRate     = FOUR_CHAR_CODE('tdrt'),       /* UInt32 * in bytes per second */
  108.     kQTSInfo_AudioAutoGainOnOff = FOUR_CHAR_CODE('agc '),       /* Boolean*  - error if unavailable*/
  109.     kQTSInfo_AudioGain          = FOUR_CHAR_CODE('gain'),       /* Fixed* kFixed1 is unity gain */
  110.     kQTSInfo_CroppedInputRect   = FOUR_CHAR_CODE('crpr'),       /* Rect* - defined relative to kQTSInfo_FullInputRect below */
  111.     kQTSInfo_SpatialSettings    = FOUR_CHAR_CODE('sptl'),       /* pointer to SCSpatialSettings struct*/
  112.     kQTSInfo_TemporalSettings   = FOUR_CHAR_CODE('tprl'),       /* pointer to SCTemporalSettings struct*/
  113.     kQTSInfo_DataRateSettings   = FOUR_CHAR_CODE('drat'),       /* pointer to SCDataRateSettings struct*/
  114.     kQTSInfo_CodecFlags         = FOUR_CHAR_CODE('cflg'),       /* pointer to CodecFlags*/
  115.     kQTSInfo_CodecSettings      = FOUR_CHAR_CODE('cdec'),       /* pointer to Handle*/
  116.     kQTSInfo_ForceKeyValue      = FOUR_CHAR_CODE('ksim'),       /* pointer to long*/
  117.     kQTSInfo_SoundSampleRate    = FOUR_CHAR_CODE('ssrt'),       /* pointer to UnsignedFixed*/
  118.     kQTSInfo_SoundSampleSize    = FOUR_CHAR_CODE('ssss'),       /* pointer to short*/
  119.     kQTSInfo_SoundChannelCount  = FOUR_CHAR_CODE('sscc'),       /* pointer to short*/
  120.     kQTSInfo_SoundCompression   = FOUR_CHAR_CODE('ssct'),       /* pointer to OSType*/
  121.     kQTSInfo_CompressionList    = FOUR_CHAR_CODE('ctyl'),       /* pointer to OSType Handle*/
  122.     kQTSInfo_VideoHue           = FOUR_CHAR_CODE('hue '),       /* UInt16* */
  123.     kQTSInfo_VideoSaturation    = FOUR_CHAR_CODE('satr'),       /* UInt16* */
  124.     kQTSInfo_VideoContrast      = FOUR_CHAR_CODE('trst'),       /* UInt16* */
  125.     kQTSInfo_VideoBrightness    = FOUR_CHAR_CODE('brit'),       /* UInt16* */
  126.     kQTSInfo_VideoSharpness     = FOUR_CHAR_CODE('shrp'),       /* UInt16* */
  127.     kQTSInfo_TimeScale          = FOUR_CHAR_CODE('scal'),       /* UInt32* */
  128.     kQTSInfo_SGChannelDeviceName = FOUR_CHAR_CODE('innm'),      /* Handle* */
  129.     kQTSInfo_SGChannelDeviceList = FOUR_CHAR_CODE('srdl'),      /* SGDeviceList* */
  130.     kQTSInfo_SGChannelDeviceInput = FOUR_CHAR_CODE('sdii'),     /* short* */
  131.     kQTSInfo_SGChannelSettings  = FOUR_CHAR_CODE('sesg'),       /* QTSSGChannelSettingsParams */
  132.     kQTSInfo_PreviewWhileRecordingMode = FOUR_CHAR_CODE('srpr'), /* Boolean* */
  133.     kQTSInfo_CompressionParams  = FOUR_CHAR_CODE('sccp')        /* QTAtomContainer* */
  134. };
  136. /* info selectors for sourcers - get only*/
  137. enum {
  138.     kQTSInfo_SGChannel          = FOUR_CHAR_CODE('sgch'),       /* SGChannel* */
  139.     kQTSInfo_SGChannelInputName = FOUR_CHAR_CODE('srnm'),       /* Handle* */
  140.     kQTSInfo_FullInputRect      = FOUR_CHAR_CODE('fulr')        /* Rect* */
  141. };
  143. /* loop flags */
  144. enum {
  145.     kQTSLoopFlag_Loop           = 0x00000001
  146. };
  148. enum {
  149.     kQTSLoopParamsVersion1      = 1
  150. };
  153. struct QTSLoopParams {
  154.     SInt32                          version;
  155.     SInt32                          flags;
  156.     SInt32                          loopFlags;
  157.     SInt32                          flagsMask;
  158.     SInt32                          numLoops;
  159. };
  160. typedef struct QTSLoopParams            QTSLoopParams;
  161. enum {
  162.     kQTSTrackParamsVersion1     = 1
  163. };
  166. struct QTSTrackParams {
  167.     SInt32                          version;
  168.     SInt32                          flags;
  169.     Track                           track;
  170.     TimeValue64                     trackStartOffset;           /* to start other than at the beginning otherwise set to 0*/
  171.     TimeValue64                     duration;                   /* to limit the duration otherwise set to 0*/
  172.     QTSLoopParams *                 loopParams;                 /* set to NULL if not using; default is no looping */
  173. };
  174. typedef struct QTSTrackParams           QTSTrackParams;
  175. enum {
  176.     kQTSSourcerTimingParamsVersion1 = 1
  177. };
  180. struct QTSSourcerTimingParams {
  181.     SInt32                          version;
  182.     SInt32                          flags;
  183.     TimeScale                       timeScale;
  184.     TimeValue64                     presentationStartTime;
  185.     TimeValue64                     presentationEndTime;
  186.     TimeValue64                     presentationCurrentTime;
  187.     TimeValue64                     localStartTime;
  188.     TimeValue64                     localEndTime;
  189.     TimeValue64                     localCurrentTime;
  190. };
  191. typedef struct QTSSourcerTimingParams   QTSSourcerTimingParams;
  192. enum {
  193.     kQTSPushDataParamsVersion1  = 1
  194. };
  196. enum {
  197.     kQTSPushDataFlag_SampleTimeIsValid = 0x00000001,
  198.     kQTSPushDataFlag_DurationIsValid = 0x00000002
  199. };
  202. struct QTSPushDataParams {
  203.     SInt32                          version;
  204.     SInt32                          flags;
  205.     SampleDescriptionHandle         sampleDescription;          /* caller owns the handle */
  206.     UInt32                          sampleDescSeed;
  207.     TimeValue64                     sampleTime;                 /* also set flag if you set this */
  208.     TimeValue64                     duration;                   /* also set flag if you set this */
  209.     UInt32                          dataLength;
  210.     void *                          dataPtr;                    /* this does not have to be a real macintosh Ptr */
  211. };
  212. typedef struct QTSPushDataParams        QTSPushDataParams;
  213. enum {
  214.     kQTSSourcerCallbackProcParamsVersion1 = 1
  215. };
  219. struct QTSSourcerCallbackProcParams {
  220.     SInt32                          version;
  221.     SInt32                          flags;
  222.     QTSNotificationUPP              proc;
  223.     void *                          refCon;
  224. };
  225. typedef struct QTSSourcerCallbackProcParams QTSSourcerCallbackProcParams;
  226. /* track sourcer callback selectors*/
  227. enum {
  228.     kQTSSourcerCallback_Done    = FOUR_CHAR_CODE('done')        /* QTSSourcerDoneParams* */
  229. };
  232. /* push data sourcer callback selectors*/
  233. enum {
  234.     kQTSPushDataSourcerCallback_HasCharacteristic = 0x050D,     /* QTSPushDataHasCharacteristicParams* */
  235.     kQTSPushDataSourcerCallback_SetInfo = 0x0507,               /* QTSPushDataInfoParams* */
  236.     kQTSPushDataSourcerCallback_GetInfo = 0x0508                /* QTSPushDataInfoParams* */
  237. };
  240. struct QTSPushDataHasCharacteristicParams {
  241.     SInt32                          version;
  242.     SInt32                          flags;
  243.     OSType                          characteristic;
  244.     Boolean                         returnedHasIt;
  245.     char                            reserved1;
  246.     char                            reserved2;
  247.     char                            reserved3;
  248. };
  249. typedef struct QTSPushDataHasCharacteristicParams QTSPushDataHasCharacteristicParams;
  251. struct QTSPushDataInfoParams {
  252.     SInt32                          version;
  253.     SInt32                          flags;
  254.     OSType                          selector;
  255.     void *                          ioParams;
  256. };
  257. typedef struct QTSPushDataInfoParams    QTSPushDataInfoParams;
  258. enum {
  259.     kQTSSourcerDoneParamsVersion1 = 1
  260. };
  263. struct QTSSourcerDoneParams {
  264.     SInt32                          version;
  265.     SInt32                          flags;
  266.     ComponentInstance               sourcer;
  267. };
  268. typedef struct QTSSourcerDoneParams     QTSSourcerDoneParams;
  270. struct QTSSGChannelSettingsParams {
  271.     UserData                        settings;
  272.     SInt32                          flags;
  273. };
  274. typedef struct QTSSGChannelSettingsParams QTSSGChannelSettingsParams;
  279. /*-----------------------------------------
  280.     Stream Sourcer Selectors
  281. -----------------------------------------*/
  282. enum {
  283.     kQTSSourcerInitializeSelect = 0x0500,
  284.     kQTSSourcerSetEnableSelect  = 0x0503,
  285.     kQTSSourcerGetEnableSelect  = 0x0504,
  286.     kQTSSourcerSetInfoSelect    = 0x0507,
  287.     kQTSSourcerGetInfoSelect    = 0x0508,
  288.     kQTSSourcerSetTimeScaleSelect = 0x050E,
  289.     kQTSSourcerGetTimeScaleSelect = 0x050F,
  290.     kQTSSourcerIdleSelect       = 0x0516
  291. };
  293. /*-----------------------------------------
  294.     Stream Sourcer Prototypes
  295. -----------------------------------------*/
  296. EXTERN_API( ComponentResult )
  297. QTSSourcerInitialize            (QTSSourcer             inSourcer,
  298.                                  const QTSSourcerInitParams * inInitParams)                 FIVEWORDINLINE(0x2F3C, 0x0004, 0x0500, 0x7000, 0xA82A);
  300. EXTERN_API( ComponentResult )
  301. QTSSourcerIdle                  (QTSSourcer             inSourcer,
  302.                                  const TimeValue64 *    inTime,
  303.                                  SInt32                 inFlags,
  304.                                  SInt32 *               outFlags)                           FIVEWORDINLINE(0x2F3C, 0x000C, 0x0516, 0x7000, 0xA82A);
  306. EXTERN_API( ComponentResult )
  307. QTSSourcerSetEnable             (QTSSourcer             inSourcer,
  308.                                  Boolean                inEnableMode,
  309.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0006, 0x0503, 0x7000, 0xA82A);
  311. EXTERN_API( ComponentResult )
  312. QTSSourcerGetEnable             (QTSSourcer             inSourcer,
  313.                                  Boolean *              outEnableMode,
  314.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0008, 0x0504, 0x7000, 0xA82A);
  316. EXTERN_API( ComponentResult )
  317. QTSSourcerSetTimeScale          (QTSSourcer             inSourcer,
  318.                                  TimeScale              inTimeScale)                        FIVEWORDINLINE(0x2F3C, 0x0004, 0x050E, 0x7000, 0xA82A);
  320. EXTERN_API( ComponentResult )
  321. QTSSourcerGetTimeScale          (QTSSourcer             inSourcer,
  322.                                  TimeScale *            outTimeScale)                       FIVEWORDINLINE(0x2F3C, 0x0004, 0x050F, 0x7000, 0xA82A);
  324. EXTERN_API( ComponentResult )
  325. QTSSourcerSetInfo               (QTSSourcer             inSourcer,
  326.                                  OSType                 inSelector,
  327.                                  void *                 ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0507, 0x7000, 0xA82A);
  329. EXTERN_API( ComponentResult )
  330. QTSSourcerGetInfo               (QTSSourcer             inSourcer,
  331.                                  OSType                 inSelector,
  332.                                  void *                 ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0508, 0x7000, 0xA82A);
  335. enum {
  336.     kQTSInfo_InputDeviceName    = FOUR_CHAR_CODE('innm'),       /* Handle* */
  337.     kQTSInfo_InputSourceName    = FOUR_CHAR_CODE('srnm')        /* Handle* */
  338. };
  343. /*============================================================================
  344.         Stream Handler
  345. ============================================================================*/
  347. /*
  348.     Server edits are only valid for the current chunk
  349. */
  351. struct SHServerEditParameters {
  352.     UInt32                          version;
  353.     Fixed                           editRate;
  354.     TimeValue64                     dataStartTime_mediaAxis;
  355.     TimeValue64                     dataEndTime_mediaAxis;
  356. };
  357. typedef struct SHServerEditParameters   SHServerEditParameters;
  358. enum {
  359.     kSHNoChunkDispatchFlags     = 0,
  360.     kSHChunkFlagSyncSample      = 1 << 2,
  361.     kSHChunkFlagDataLoss        = 1 << 4,
  362.     kSHChunkFlagExtended        = 1 << 5
  363. };
  366. struct SHChunkRecord {
  367.     UInt32                          version;
  368.     long                            reserved1;
  369.     SInt32                          flags;
  370.     UInt32                          dataSize;
  371.     UInt8 *                         dataPtr;
  372.     long                            reserved2;
  373.     long                            reserved3;
  374.     TimeValue64                     presentationTime;
  376.     long                            reserved4;
  377.     long                            reserved5;
  378.     const SHServerEditParameters *  serverEditParameters;
  379.     long                            reserved6;
  380.     long                            reserved7;
  381. };
  382. typedef struct SHChunkRecord            SHChunkRecord;
  383. enum {
  384.     kSHNumExtendedDataLongs     = 10
  385. };
  387. enum {
  388.     kSHExtendedChunkFlag_HasSampleCount = 1 << 0,
  389.     kSHExtendedChunkFlag_HasFrameLengths = 1 << 1
  390. };
  393. struct SHExtendedChunkRecord {
  394.     SHChunkRecord                   chunk;
  395.     SInt32                          extendedFlags;
  396.     SInt32                          extendedData[10];
  397. };
  398. typedef struct SHExtendedChunkRecord    SHExtendedChunkRecord;
  400. /*============================================================================
  401.         RTP Components
  402. ============================================================================*/
  404. typedef UInt32                          RTPSSRC;
  405. enum {
  406.     kRTPInvalidSSRC             = 0
  407. };
  410. /* RTP standard content encodings for audio */
  411. enum {
  412.     kRTPPayload_PCMU            = 0,                            /* 8kHz PCM mu-law mono */
  413.     kRTPPayload_1016            = 1,                            /* 8kHz CELP (Fed Std 1016) mono */
  414.     kRTPPayload_G721            = 2,                            /* 8kHz G.721 ADPCM mono */
  415.     kRTPPayload_GSM             = 3,                            /* 8kHz GSM mono */
  416.     kRTPPayload_G723            = 4,                            /* 8kHz G.723 ADPCM mono */
  417.     kRTPPayload_DVI_8           = 5,                            /* 8kHz Intel DVI ADPCM mono */
  418.     kRTPPayload_DVI_16          = 6,                            /* 16kHz Intel DVI ADPCM mono */
  419.     kRTPPayload_LPC             = 7,                            /* 8kHz LPC */
  420.     kRTPPayload_PCMA            = 8,                            /* 8kHz PCM a-law mono */
  421.     kRTPPayload_L16_44_2        = 10,                           /* 44.1kHz 16-bit linear stereo */
  422.     kRTPPayload_L16_44_1        = 11,                           /* 44.1kHz 16-bit linear mono */
  423.     kRTPPayload_PureVoice       = 12,                           /* 8kHz PureVoice mono (QCELP) */
  424.     kRTPPayload_MPEGAUDIO       = 14,                           /* MPEG I and II audio */
  425.     kRTPPayload_DVI_11          = 16,                           /* 11kHz Intel DVI ADPCM mono */
  426.     kRTPPayload_DVI_22          = 17                            /* 22kHz Intel DVI ADPCM mono */
  427. };
  429. /* RTP standard content encodings for video */
  430. enum {
  431.     kRTPPayload_CELLB           = 25,                           /* Sun CellB */
  432.     kRTPPayload_JPEG            = 26,                           /* JPEG */
  433.     kRTPPayload_CUSEEME         = 27,                           /* Cornell CU-SeeMe */
  434.     kRTPPayload_NV              = 28,                           /* Xerox PARC nv */
  435.     kRTPPayload_PICWIN          = 29,                           /* BBN Picture Window */
  436.     kRTPPayload_CPV             = 30,                           /* Bolter CPV */
  437.     kRTPPayload_H261            = 31,                           /* CCITT H.261 */
  438.     kRTPPayload_MPEGVIDEO       = 32,                           /* MPEG I and II video */
  439.     kRTPPayload_H263            = 34                            /* CCITT H.263 */
  440. };
  442. /* Other RTP standard content encodings */
  443. enum {
  444.     kRTPPayload_MPEG2T          = 33                            /* MPEG 2 Transport */
  445. };
  447. /* Dynamic encodings */
  448. enum {
  449.     kRTPPayload_FirstDynamic    = 96,
  450.     kRTPPayload_LastDynamic     = 127,
  451.     kRTPPayload_Unknown         = 0xFF
  452. };
  456. /*
  457. -----------------------------------------
  458.     RTP Info selectors
  459. -----------------------------------------
  460. */
  461. /* ----- these are get and set ----- */
  462. enum {
  463.     kRTPInfo_SSRC               = FOUR_CHAR_CODE('ssrc'),       /* UInt32* */
  464.     kRTPInfo_NextSeqNum         = FOUR_CHAR_CODE('rnsn')        /* UInt16* */
  465. };
  467. /*-----------------------------------------
  468.     RTP Statistics
  469. -----------------------------------------*/
  470. enum {
  471.     kRTPTotalReceivedPktsStat   = FOUR_CHAR_CODE('trcp'),
  472.     kRTPTotalLostPktsStat       = FOUR_CHAR_CODE('tlsp'),
  473.     kRTPTotalProcessedPktsStat  = FOUR_CHAR_CODE('tprp'),
  474.     kRTPTotalDroppedPktsStat    = FOUR_CHAR_CODE('tdrp'),
  475.     kRTPBadHeaderDroppedPktsStat = FOUR_CHAR_CODE('bhdp'),
  476.     kRTPOurHeaderDroppedPktsStat = FOUR_CHAR_CODE('ohdp'),
  477.     kRTPNotReceivingSenderDroppedPktsStat = FOUR_CHAR_CODE('nsdp'),
  478.     kRTPNotProcessingDroppedPktsStat = FOUR_CHAR_CODE('npdp'),
  479.     kRTPBadSeqDroppedPktsStat   = FOUR_CHAR_CODE('bsdp'),
  480.     kRTPArriveTooLatePktsStat   = FOUR_CHAR_CODE('artl'),
  481.     kRTPWaitForSeqDroppedPktsStat = FOUR_CHAR_CODE('wsdp'),
  482.     kRTPBadStateDroppedPktsStat = FOUR_CHAR_CODE('stdp'),
  483.     kRTPBadPayloadDroppedPktsStat = FOUR_CHAR_CODE('bpdp'),
  484.     kRTPNoTimeScaleDroppedPktsStat = FOUR_CHAR_CODE('ntdp'),
  485.     kRTPDupSeqNumDroppedPktsStat = FOUR_CHAR_CODE('dsdp'),
  486.     kRTPLostPktsPercentStat     = FOUR_CHAR_CODE('lspp'),
  487.     kRTPDroppedPktsPercentStat  = FOUR_CHAR_CODE('dppp'),
  488.     kRTPTotalUnprocessedPktsPercentStat = FOUR_CHAR_CODE('tupp'),
  489.     kRTPRTCPDataRateStat        = FOUR_CHAR_CODE('rrcd'),
  490.     kRTPPayloadIDStat           = FOUR_CHAR_CODE('rpid'),
  491.     kRTPPayloadNameStat         = FOUR_CHAR_CODE('rpnm'),
  492.     kRTPNumPktsInQueueStat      = FOUR_CHAR_CODE('rnpq'),
  493.     kRTPTotalPktsInQueueStat    = FOUR_CHAR_CODE('rtpq'),
  494.     kRTPTotalOutOfOrderPktsStat = FOUR_CHAR_CODE('rtoo'),
  495.     kRTPRetransmissionStat      = FOUR_CHAR_CODE('rrtx')
  496. };
  499. /*-----------------------------------------
  500.     Payload Info
  501. -----------------------------------------*/
  502. enum {
  503.     kRTPPayloadSpeedTag         = FOUR_CHAR_CODE('sped'),       /* 0-255, 255 is fastest*/
  504.     kRTPPayloadLossRecoveryTag  = FOUR_CHAR_CODE('loss'),       /* 0-255, 0 can't handle any loss, 128 can handle 50% packet loss*/
  505.     kRTPPayloadConformanceTag   = FOUR_CHAR_CODE('conf')        /* more than one of these can be present*/
  506. };
  510. struct RTPPayloadCharacteristic {
  511.     OSType                          tag;
  512.     long                            value;
  513. };
  514. typedef struct RTPPayloadCharacteristic RTPPayloadCharacteristic;
  515. /*
  516.     pass RTPPayloadSortRequest to QTSFindMediaPacketizer or QTSFindMediaPacketizerForTrack.
  517.     define the characteristics to sort by. tag is key to sort on. value is positive for ascending
  518.     sort (low value first), negative for descending sort (high value first).
  519. */
  521. struct RTPPayloadSortRequest {
  522.     long                            characteristicCount;
  523.     RTPPayloadCharacteristic        characteristic[1];          /* tag is key to sort on, value is + for ascending, - for descending*/
  524. };
  525. typedef struct RTPPayloadSortRequest    RTPPayloadSortRequest;
  526. typedef RTPPayloadSortRequest *         RTPPayloadSortRequestPtr;
  527. /* flags for RTPPayloadInfo */
  528. enum {
  529.     kRTPPayloadTypeStaticFlag   = 0x00000001,
  530.     kRTPPayloadTypeDynamicFlag  = 0x00000002
  531. };
  534. struct RTPPayloadInfo {
  535.     long                            payloadFlags;
  536.     UInt8                           payloadID;
  537.     char                            reserved1;
  538.     char                            reserved2;
  539.     char                            reserved3;
  540.     char                            payloadName[1];
  541. };
  542. typedef struct RTPPayloadInfo           RTPPayloadInfo;
  543. typedef RTPPayloadInfo *                RTPPayloadInfoPtr;
  544. typedef RTPPayloadInfoPtr *             RTPPayloadInfoHandle;
  545. /*============================================================================
  546.         RTP Reassembler
  547. ============================================================================*/
  549. typedef ComponentInstance               RTPReassembler;
  550. enum {
  551.     kRTPReassemblerType         = FOUR_CHAR_CODE('rtpr')
  552. };
  554. enum {
  555.     kRTPBaseReassemblerType     = FOUR_CHAR_CODE('gnrc'),
  556.     kRTP261ReassemblerType      = FOUR_CHAR_CODE('h261'),
  557.     kRTP263ReassemblerType      = FOUR_CHAR_CODE('h263'),
  558.     kRTP263PlusReassemblerType  = FOUR_CHAR_CODE('263+'),
  559.     kRTPAudioReassemblerType    = FOUR_CHAR_CODE('soun'),
  560.     kRTPQTReassemblerType       = FOUR_CHAR_CODE('qtim'),
  561.     kRTPPureVoiceReassemblerType = FOUR_CHAR_CODE('Qclp'),
  562.     kRTPJPEGReassemblerType     = FOUR_CHAR_CODE('jpeg'),
  563.     kRTPQDesign2ReassemblerType = FOUR_CHAR_CODE('QDM2'),
  564.     kRTPSorensonReassemblerType = FOUR_CHAR_CODE('SVQ1'),
  565.     kRTPMP3ReassemblerType      = FOUR_CHAR_CODE('mp3 '),
  566.     kRTPMPEG4AudioReassemblerType = FOUR_CHAR_CODE('mp4a'),
  567.     kRTPMPEG4VideoReassemblerType = FOUR_CHAR_CODE('mp4v')
  568. };
  571. struct RTPRssmInitParams {
  572.     RTPSSRC                         ssrc;
  573.     UInt8                           payloadType;
  574.     UInt8                           reserved1;
  575.     UInt8                           reserved2;
  576.     UInt8                           reserved3;
  577.     TimeBase                        timeBase;
  578.     TimeScale                       timeScale;
  579. };
  580. typedef struct RTPRssmInitParams        RTPRssmInitParams;
  582. struct RTPDescParams {
  583.     QTAtomContainer                 container;
  584.     QTAtom                          presentationParentAtom;
  585.     QTAtom                          streamParentAtom;
  586. };
  587. typedef struct RTPDescParams            RTPDescParams;
  589. struct RTPRssmMoreInitParams {
  590.     RTPRssmInitParams               initParams;
  591.     SInt32                          version;
  592.     RTPDescParams                   desc;
  593. };
  594. typedef struct RTPRssmMoreInitParams    RTPRssmMoreInitParams;
  595. enum {
  596.     kRTPRssmMoreInitParamsVersion1 = 1
  597. };
  600. /* get/set info selectors*/
  601. enum {
  602.     kRTPRssmInfo_MoreInitParams = FOUR_CHAR_CODE('rrmi')
  603. };
  607. struct RTPRssmPacket {
  608.     struct RTPRssmPacket *          next;
  609.     struct RTPRssmPacket *          prev;
  610.     QTSStreamBuffer *               streamBuffer;
  611.     Boolean                         paramsFilledIn;
  612.     UInt8                           reserved;
  613.     UInt16                          sequenceNum;
  614.     UInt32                          transportHeaderLength;      /* filled in by base*/
  615.     UInt32                          payloadHeaderLength;        /* derived adjusts this */
  616.     UInt32                          dataLength;
  617.     SHServerEditParameters          serverEditParams;
  618.     TimeValue64                     timeStamp;                  /* lower 32 bits is original rtp timestamp*/
  619.     SInt32                          chunkFlags;                 /* these are or'd together*/
  620.     SInt32                          flags;
  622. };
  623. typedef struct RTPRssmPacket            RTPRssmPacket;
  624. /* flags for RTPRssmPacket struct*/
  625. enum {
  626.     kRTPRssmPacketHasMarkerBitSet = 0x00000001,
  627.     kRTPRssmPacketHasServerEditFlag = 0x00010000
  628. };
  630. /* flags for RTPRssmSendStreamBufferRange*/
  631. enum {
  632.     kRTPRssmCanRefStreamBuffer  = 0x00000001
  633. };
  635. /* flags for RTPRssmSendPacketList*/
  636. enum {
  637.     kRTPRssmLostSomePackets     = 0x00000001
  638. };
  640. /* flags for RTPRssmSetFlags*/
  641. enum {
  642.     kRTPRssmEveryPacketAChunkFlag = 0x00000001,
  643.     kRTPRssmQueueAndUseMarkerBitFlag = 0x00000002,
  644.     kRTPRssmTrackLostPacketsFlag = 0x00010000,
  645.     kRTPRssmNoReorderingRequiredFlag = 0x00020000
  646. };
  650. struct RTPSendStreamBufferRangeParams {
  651.     QTSStreamBuffer *               streamBuffer;
  652.     TimeValue64                     presentationTime;
  653.     UInt32                          chunkStartPosition;
  654.     UInt32                          numDataBytes;
  655.     SInt32                          chunkFlags;
  656.     SInt32                          flags;
  657.     const SHServerEditParameters *  serverEditParams;           /* NULL if no edit*/
  658. };
  659. typedef struct RTPSendStreamBufferRangeParams RTPSendStreamBufferRangeParams;
  660. /* characteristics*/
  661. enum {
  662.     kRTPCharacteristic_RequiresOrderedPackets = FOUR_CHAR_CODE('rrop'),
  663.     kRTPCharacteristic_TimeStampsNotMonoIncreasing = FOUR_CHAR_CODE('tsmi')
  664. };
  667. enum {
  668.     kRTPReassemblerInfoResType  = FOUR_CHAR_CODE('rsmi')
  669. };
  672. struct RTPReassemblerInfo {
  673.     long                            characteristicCount;
  674.     RTPPayloadCharacteristic        characteristic[1];
  676.                                                                 /* after the last characteristic, the payload name (defined by the MediaPacketizerPayloadInfo*/
  677.                                                                 /* structure) is present. */
  678. };
  679. typedef struct RTPReassemblerInfo       RTPReassemblerInfo;
  680. typedef RTPReassemblerInfo *            RTPReassemblerInfoPtr;
  681. typedef RTPReassemblerInfoPtr *         RTPReassemblerInfoHandle;
  682. #define RTPReassemblerInfoToPayloadInfo(_rsmi) ((RTPPayloadInfoPtr)(&((_rsmi)->characteristic[(_rsmi)->characteristicCount])))
  683. /* RTPReassemblerInfoElement structs are padded to 32 bits */
  684. enum {
  685.     kRTPReassemblerInfoPadUpToBytes = 4
  686. };
  689. EXTERN_API_C( OSErr )
  690. QTSFindReassemblerForPayloadID  (UInt8                  inPayloadID,
  691.                                  RTPPayloadSortRequest * inSortInfo,
  692.                                  QTAtomContainer *      outReassemblerList);
  694. EXTERN_API_C( OSErr )
  695. QTSFindReassemblerForPayloadName (const char *          inPayloadName,
  696.                                  RTPPayloadSortRequest * inSortInfo,
  697.                                  QTAtomContainer *      outReassemblerList);
  699. /*-----------------------------------------
  700.     RTP Reassembler Selectors
  701. -----------------------------------------*/
  702. enum {
  703.     kRTPRssmSetCapabilitiesSelect = 0x0100,
  704.     kRTPRssmGetCapabilitiesSelect = 0x0101,
  705.     kRTPRssmSetPayloadHeaderLengthSelect = 0x0102,
  706.     kRTPRssmGetPayloadHeaderLengthSelect = 0x0103,
  707.     kRTPRssmSetTimeScaleSelect  = 0x0104,
  708.     kRTPRssmGetTimeScaleSelect  = 0x0105,
  709.     kRTPRssmNewStreamHandlerSelect = 0x0106,
  710.     kRTPRssmSetStreamHandlerSelect = 0x0107,
  711.     kRTPRssmGetStreamHandlerSelect = 0x0108,
  712.     kRTPRssmSendStreamHandlerChangedSelect = 0x0109,
  713.     kRTPRssmSetSampleDescriptionSelect = 0x010A,
  714.     kRTPRssmGetChunkAndIncrRefCountSelect = 0x010D,
  715.     kRTPRssmSendChunkAndDecrRefCountSelect = 0x010E,
  716.     kRTPRssmSendLostChunkSelect = 0x010F,
  717.     kRTPRssmSendStreamBufferRangeSelect = 0x0110,
  718.     kRTPRssmClearCachedPackets  = 0x0111,
  719.     kRTPRssmFillPacketListParamsSelect = 0x0113,
  720.     kRTPRssmReleasePacketListSelect = 0x0114,
  721.     kRTPRssmIncrChunkRefCountSelect = 0x0115,
  722.     kRTPRssmDecrChunkRefCountSelect = 0x0116,
  723.     kRTPRssmGetExtChunkAndIncrRefCountSelect = 0x0117,
  724.     kRTPRssmInitializeSelect    = 0x0500,
  725.     kRTPRssmHandleNewPacketSelect = 0x0501,
  726.     kRTPRssmComputeChunkSizeSelect = 0x0502,
  727.     kRTPRssmAdjustPacketParamsSelect = 0x0503,
  728.     kRTPRssmCopyDataToChunkSelect = 0x0504,
  729.     kRTPRssmSendPacketListSelect = 0x0505,
  730.     kRTPRssmGetTimeScaleFromPacketSelect = 0x0506,
  731.     kRTPRssmSetInfoSelect       = 0x0509,
  732.     kRTPRssmGetInfoSelect       = 0x050A,
  733.     kRTPRssmHasCharacteristicSelect = 0x050B,
  734.     kRTPRssmResetSelect         = 0x050C
  735. };
  737. /*-----------------------------------------
  738.     RTP Reassembler functions - base to derived
  739. -----------------------------------------*/
  741. EXTERN_API( ComponentResult )
  742. RTPRssmInitialize               (RTPReassembler         rtpr,
  743.                                  RTPRssmInitParams *    inInitParams)                       FIVEWORDINLINE(0x2F3C, 0x0004, 0x0500, 0x7000, 0xA82A);
  745. EXTERN_API( ComponentResult )
  746. RTPRssmHandleNewPacket          (RTPReassembler         rtpr,
  747.                                  QTSStreamBuffer *      inStreamBuffer,
  748.                                  SInt32                 inNumWraparounds)                   FIVEWORDINLINE(0x2F3C, 0x0008, 0x0501, 0x7000, 0xA82A);
  750. EXTERN_API( ComponentResult )
  751. RTPRssmComputeChunkSize         (RTPReassembler         rtpr,
  752.                                  RTPRssmPacket *        inPacketListHead,
  753.                                  SInt32                 inFlags,
  754.                                  UInt32 *               outChunkDataSize)                   FIVEWORDINLINE(0x2F3C, 0x000C, 0x0502, 0x7000, 0xA82A);
  756. EXTERN_API( ComponentResult )
  757. RTPRssmAdjustPacketParams       (RTPReassembler         rtpr,
  758.                                  RTPRssmPacket *        inPacket,
  759.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0008, 0x0503, 0x7000, 0xA82A);
  761. EXTERN_API( ComponentResult )
  762. RTPRssmCopyDataToChunk          (RTPReassembler         rtpr,
  763.                                  RTPRssmPacket *        inPacketListHead,
  764.                                  UInt32                 inMaxChunkDataSize,
  765.                                  SHChunkRecord *        inChunk,
  766.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0010, 0x0504, 0x7000, 0xA82A);
  768. EXTERN_API( ComponentResult )
  769. RTPRssmSendPacketList           (RTPReassembler         rtpr,
  770.                                  RTPRssmPacket *        inPacketListHead,
  771.                                  const TimeValue64 *    inLastChunkPresentationTime,
  772.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x000C, 0x0505, 0x7000, 0xA82A);
  774. EXTERN_API( ComponentResult )
  775. RTPRssmGetTimeScaleFromPacket   (RTPReassembler         rtpr,
  776.                                  QTSStreamBuffer *      inStreamBuffer,
  777.                                  TimeScale *            outTimeScale)                       FIVEWORDINLINE(0x2F3C, 0x0008, 0x0506, 0x7000, 0xA82A);
  779. EXTERN_API( ComponentResult )
  780. RTPRssmSetInfo                  (RTPReassembler         rtpr,
  781.                                  OSType                 inSelector,
  782.                                  void *                 ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0509, 0x7000, 0xA82A);
  784. EXTERN_API( ComponentResult )
  785. RTPRssmGetInfo                  (RTPReassembler         rtpr,
  786.                                  OSType                 inSelector,
  787.                                  void *                 ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x050A, 0x7000, 0xA82A);
  789. EXTERN_API( ComponentResult )
  790. RTPRssmHasCharacteristic        (RTPReassembler         rtpr,
  791.                                  OSType                 inCharacteristic,
  792.                                  Boolean *              outHasIt)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x050B, 0x7000, 0xA82A);
  794. EXTERN_API( ComponentResult )
  795. RTPRssmReset                    (RTPReassembler         rtpr,
  796.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0004, 0x050C, 0x7000, 0xA82A);
  798. /*-----------------------------------------
  799.     RTP Reassembler functions - derived to base
  800. -----------------------------------------*/
  801. /* ----- setup*/
  802. EXTERN_API( ComponentResult )
  803. RTPRssmSetCapabilities          (RTPReassembler         rtpr,
  804.                                  SInt32                 inFlags,
  805.                                  SInt32                 inFlagsMask)                        FIVEWORDINLINE(0x2F3C, 0x0008, 0x0100, 0x7000, 0xA82A);
  807. EXTERN_API( ComponentResult )
  808. RTPRssmGetCapabilities          (RTPReassembler         rtpr,
  809.                                  SInt32 *               outFlags)                           FIVEWORDINLINE(0x2F3C, 0x0004, 0x0101, 0x7000, 0xA82A);
  811. EXTERN_API( ComponentResult )
  812. RTPRssmSetPayloadHeaderLength   (RTPReassembler         rtpr,
  813.                                  UInt32                 inPayloadHeaderLength)              FIVEWORDINLINE(0x2F3C, 0x0004, 0x0102, 0x7000, 0xA82A);
  815. EXTERN_API( ComponentResult )
  816. RTPRssmGetPayloadHeaderLength   (RTPReassembler         rtpr,
  817.                                  UInt32 *               outPayloadHeaderLength)             FIVEWORDINLINE(0x2F3C, 0x0004, 0x0103, 0x7000, 0xA82A);
  819. EXTERN_API( ComponentResult )
  820. RTPRssmSetTimeScale             (RTPReassembler         rtpr,
  821.                                  TimeScale              inSHTimeScale)                      FIVEWORDINLINE(0x2F3C, 0x0004, 0x0104, 0x7000, 0xA82A);
  823. EXTERN_API( ComponentResult )
  824. RTPRssmGetTimeScale             (RTPReassembler         rtpr,
  825.                                  TimeScale *            outSHTimeScale)                     FIVEWORDINLINE(0x2F3C, 0x0004, 0x0105, 0x7000, 0xA82A);
  827. EXTERN_API( ComponentResult )
  828. RTPRssmNewStreamHandler         (RTPReassembler         rtpr,
  829.                                  OSType                 inSHType,
  830.                                  SampleDescriptionHandle  inSampleDescription,
  831.                                  TimeScale              inSHTimeScale,
  832.                                  ComponentInstance *    outHandler)                         FIVEWORDINLINE(0x2F3C, 0x0010, 0x0106, 0x7000, 0xA82A);
  834. EXTERN_API( ComponentResult )
  835. RTPRssmSetStreamHandler         (RTPReassembler         rtpr,
  836.                                  ComponentInstance      inStreamHandler)                    FIVEWORDINLINE(0x2F3C, 0x0004, 0x0107, 0x7000, 0xA82A);
  838. EXTERN_API( ComponentResult )
  839. RTPRssmGetStreamHandler         (RTPReassembler         rtpr,
  840.                                  ComponentInstance *    outStreamHandler)                   FIVEWORDINLINE(0x2F3C, 0x0004, 0x0108, 0x7000, 0xA82A);
  843. EXTERN_API( ComponentResult )
  844. RTPRssmSendStreamHandlerChanged (RTPReassembler         rtpr)                               FIVEWORDINLINE(0x2F3C, 0x0000, 0x0109, 0x7000, 0xA82A);
  846. EXTERN_API( ComponentResult )
  847. RTPRssmSetSampleDescription     (RTPReassembler         rtpr,
  848.                                  SampleDescriptionHandle  inSampleDescription)              FIVEWORDINLINE(0x2F3C, 0x0004, 0x010A, 0x7000, 0xA82A);
  850. /* ----- manually sending chunks*/
  851. EXTERN_API( ComponentResult )
  852. RTPRssmGetChunkAndIncrRefCount  (RTPReassembler         rtpr,
  853.                                  UInt32                 inChunkDataSize,
  854.                                  const TimeValue64 *    inChunkPresentationTime,
  855.                                  SHChunkRecord **       outChunk)                           FIVEWORDINLINE(0x2F3C, 0x000C, 0x010D, 0x7000, 0xA82A);
  857. EXTERN_API( ComponentResult )
  858. RTPRssmGetExtChunkAndIncrRefCount (RTPReassembler       rtpr,
  859.                                  UInt32                 inChunkDataSize,
  860.                                  const TimeValue64 *    inChunkPresentationTime,
  861.                                  SInt32                 inFlags,
  862.                                  SHExtendedChunkRecord ** outChunk)                         FIVEWORDINLINE(0x2F3C, 0x0010, 0x0117, 0x7000, 0xA82A);
  864. EXTERN_API( ComponentResult )
  865. RTPRssmSendChunkAndDecrRefCount (RTPReassembler         rtpr,
  866.                                  SHChunkRecord *        inChunk,
  867.                                  const SHServerEditParameters * inServerEdit)               FIVEWORDINLINE(0x2F3C, 0x0008, 0x010E, 0x7000, 0xA82A);
  869. EXTERN_API( ComponentResult )
  870. RTPRssmSendLostChunk            (RTPReassembler         rtpr,
  871.                                  const TimeValue64 *    inChunkPresentationTime)            FIVEWORDINLINE(0x2F3C, 0x0004, 0x010F, 0x7000, 0xA82A);
  873. EXTERN_API( ComponentResult )
  874. RTPRssmSendStreamBufferRange    (RTPReassembler         rtpr,
  875.                                  RTPSendStreamBufferRangeParams * inParams)                 FIVEWORDINLINE(0x2F3C, 0x0004, 0x0110, 0x7000, 0xA82A);
  877. EXTERN_API( ComponentResult )
  878. RTPRssmClearCachedPackets       (RTPReassembler         rtpr,
  879.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0004, 0x0111, 0x7000, 0xA82A);
  881. EXTERN_API( ComponentResult )
  882. RTPRssmFillPacketListParams     (RTPReassembler         rtpr,
  883.                                  RTPRssmPacket *        inPacketListHead,
  884.                                  SInt32                 inNumWraparounds,
  885.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x000C, 0x0113, 0x7000, 0xA82A);
  887. EXTERN_API( ComponentResult )
  888. RTPRssmReleasePacketList        (RTPReassembler         rtpr,
  889.                                  RTPRssmPacket *        inPacketListHead)                   FIVEWORDINLINE(0x2F3C, 0x0004, 0x0114, 0x7000, 0xA82A);
  891. EXTERN_API( ComponentResult )
  892. RTPRssmIncrChunkRefCount        (RTPReassembler         rtpr,
  893.                                  SHChunkRecord *        inChunk)                            FIVEWORDINLINE(0x2F3C, 0x0004, 0x0115, 0x7000, 0xA82A);
  895. EXTERN_API( ComponentResult )
  896. RTPRssmDecrChunkRefCount        (RTPReassembler         rtpr,
  897.                                  SHChunkRecord *        inChunk)                            FIVEWORDINLINE(0x2F3C, 0x0004, 0x0116, 0x7000, 0xA82A);
  899. /*============================================================================
  900.         RTP Media Packetizer
  901. ============================================================================*/
  902. enum {
  903.     kRTPMediaPacketizerType     = FOUR_CHAR_CODE('rtpm')
  904. };
  907. typedef ComponentInstance               RTPMediaPacketizer;
  908. enum {
  909.     kRTPBaseMediaPacketizerType = FOUR_CHAR_CODE('gnrc'),
  910.     kRTP261MediaPacketizerType  = FOUR_CHAR_CODE('h261'),
  911.     kRTP263PlusMediaPacketizerType = FOUR_CHAR_CODE('263+'),
  912.     kRTPAudioMediaPacketizerType = FOUR_CHAR_CODE('soun'),
  913.     kRTPQTMediaPacketizerType   = FOUR_CHAR_CODE('qtim'),
  914.     kRTPPureVoiceMediaPacketizerType = FOUR_CHAR_CODE('Qclp'),
  915.     kRTPJPEGMediaPacketizerType = FOUR_CHAR_CODE('jpeg'),
  916.     kRTPQDesign2MediaPacketizerType = FOUR_CHAR_CODE('QDM2'),
  917.     kRTPSorensonMediaPacketizerType = FOUR_CHAR_CODE('SVQ1'),
  918.     kRTPMP3MediaPacketizerType  = FOUR_CHAR_CODE('mp3 '),
  919.     kRTPMPEG4AudioMediaPacketizerType = FOUR_CHAR_CODE('mp4a'),
  920.     kRTPMPEG4VideoMediaPacketizerType = FOUR_CHAR_CODE('mp4v')
  921. };
  923. typedef UInt32                          RTPMPSampleRef;
  924. typedef CALLBACK_API( void , RTPMPDataReleaseProcPtr )(UInt8 *inData, void *inRefCon);
  925. typedef STACK_UPP_TYPE(RTPMPDataReleaseProcPtr)                 RTPMPDataReleaseUPP;
  926. enum {
  927.     kMediaPacketizerCanPackEditRate = 1 << 0,
  928.     kMediaPacketizerCanPackLayer = 1 << 1,
  929.     kMediaPacketizerCanPackVolume = 1 << 2,
  930.     kMediaPacketizerCanPackBalance = 1 << 3,
  931.     kMediaPacketizerCanPackGraphicsMode = 1 << 4,
  932.     kMediaPacketizerCanPackEmptyEdit = 1 << 5
  933. };
  937. struct MediaPacketizerRequirements {
  938.     OSType                          mediaType;                  /* media type supported (0 for all)*/
  939.     OSType                          dataFormat;                 /* data format (e.g., compression) supported (0 for all)*/
  940.     UInt32                          capabilityFlags;            /* ability to handle non-standard track characteristics*/
  941.     UInt8                           canPackMatrixType;          /* can pack any matrix type up to this (identityMatrixType for identity only)*/
  942.     UInt8                           reserved1;
  943.     UInt8                           reserved2;
  944.     UInt8                           reserved3;
  945. };
  946. typedef struct MediaPacketizerRequirements MediaPacketizerRequirements;
  947. typedef MediaPacketizerRequirements *   MediaPacketizerRequirementsPtr;
  949. struct MediaPacketizerInfo {
  950.     OSType                          mediaType;                  /* media type supported (0 for all)*/
  951.     OSType                          dataFormat;                 /* data format (e.g., compression) supported (0 for all)*/
  952.     OSType                          vendor;                     /* manufacturer of this packetizer (e.g., 'appl' for Apple)*/
  953.     UInt32                          capabilityFlags;            /* ability to handle non-standard track characteristics*/
  954.     UInt8                           canPackMatrixType;          /* can pack any matrix type up to this (identityMatrixType for identity only)*/
  955.     UInt8                           reserved1;
  956.     UInt8                           reserved2;
  957.     UInt8                           reserved3;
  958.     long                            characteristicCount;
  959.     RTPPayloadCharacteristic        characteristic[1];
  961.                                                                 /* after the last characteristic, the payload name (defined by the RTPPayloadInfo*/
  962.                                                                 /* structure) is present. */
  963. };
  964. typedef struct MediaPacketizerInfo      MediaPacketizerInfo;
  965. typedef MediaPacketizerInfo *           MediaPacketizerInfoPtr;
  966. typedef MediaPacketizerInfoPtr *        MediaPacketizerInfoHandle;
  967. #define MediaPacketizerInfoToPayloadInfo(_mpi) ((RTPPayloadInfoPtr)(&((_mpi)->characteristic[(_mpi)->characteristicCount])))
  968. /* MediaPacketizerInfo structs are padded to 32 bits */
  969. enum {
  970.     kMediaPacketizerInfoPadUpToBytes = 4
  971. };
  973. enum {
  974.     kRTPMediaPacketizerInfoRezType = FOUR_CHAR_CODE('pcki')
  975. };
  978. EXTERN_API_C( OSErr )
  979. QTSFindMediaPacketizer          (MediaPacketizerRequirementsPtr  inPacketizerinfo,
  980.                                  SampleDescriptionHandle  inSampleDescription,
  981.                                  RTPPayloadSortRequestPtr  inSortInfo,
  982.                                  QTAtomContainer *      outPacketizerList);
  984. EXTERN_API_C( OSErr )
  985. QTSFindMediaPacketizerForTrack  (Track                  inTrack,
  986.                                  long                   inSampleDescriptionIndex,
  987.                                  RTPPayloadSortRequestPtr  inSortInfo,
  988.                                  QTAtomContainer *      outPacketizerList);
  990. EXTERN_API_C( OSErr )
  991. QTSFindMediaPacketizerForPayloadID (long                payloadID,
  992.                                  RTPPayloadSortRequestPtr  inSortInfo,
  993.                                  QTAtomContainer *      outPacketizerList);
  995. EXTERN_API_C( OSErr )
  996. QTSFindMediaPacketizerForPayloadName (const char *      payloadName,
  997.                                  RTPPayloadSortRequestPtr  inSortInfo,
  998.                                  QTAtomContainer *      outPacketizerList);
  1000. /* flags for RTPMPInitialize*/
  1001. enum {
  1002.     kRTPMPRealtimeModeFlag      = 0x00000001
  1003. };
  1005. /* flags for RTPMPSampleDataParams*/
  1006. enum {
  1007.     kRTPMPSyncSampleFlag        = 0x00000001,
  1008.     kRTPMPRespectDurationFlag   = 0x00000002
  1009. };
  1012. struct RTPMPSampleDataParams {
  1013.     UInt32                          version;
  1014.     UInt32                          timeStamp;
  1015.     UInt32                          duration;                   /* 0 = unknown duration*/
  1016.     UInt32                          playOffset;
  1017.     Fixed                           playRate;
  1018.     SInt32                          flags;
  1019.     UInt32                          sampleDescSeed;
  1020.     Handle                          sampleDescription;
  1021.     RTPMPSampleRef                  sampleRef;
  1022.     UInt32                          dataLength;
  1023.     const UInt8 *                   data;
  1024.     RTPMPDataReleaseUPP             releaseProc;
  1025.     void *                          refCon;
  1026. };
  1027. typedef struct RTPMPSampleDataParams    RTPMPSampleDataParams;
  1028. /* out flags for idle, RTPMPSetSampleData, and RTPMPFlush*/
  1029. enum {
  1030.     kRTPMPStillProcessingData   = 0x00000001                    /* not done with data you've got*/
  1031. };
  1034. struct RTPMPPayloadTypeParams {
  1035.     UInt32                          flags;
  1036.     UInt32                          payloadNumber;
  1037.     short                           nameLength;                 /* in: size of payloadName buffer (counting null terminator) -- this will be reset to needed length and paramErr returned if too small */
  1038.     char *                          payloadName;                /* caller must provide buffer */
  1039. };
  1040. typedef struct RTPMPPayloadTypeParams   RTPMPPayloadTypeParams;
  1041. /*-----------------------------------------
  1042.     RTP Media Packetizer Info selectors
  1043. -----------------------------------------*/
  1044. /* info selectors - get only */
  1045. enum {
  1046.     kRTPMPPayloadTypeInfo       = FOUR_CHAR_CODE('rtpp'),       /* RTPMPPayloadTypeParams* */
  1047.     kRTPMPRTPTimeScaleInfo      = FOUR_CHAR_CODE('rtpt'),       /* TimeScale* */
  1048.     kRTPMPRequiredSampleDescriptionInfo = FOUR_CHAR_CODE('sdsc'), /* SampleDescriptionHandle* */
  1049.     kRTPMPMinPayloadSize        = FOUR_CHAR_CODE('mins'),       /* UInt32* in bytes, does not include rtp header; default is 0 */
  1050.     kRTPMPMinPacketDuration     = FOUR_CHAR_CODE('mind'),       /* UInt3* in milliseconds; default is no min required */
  1051.     kRTPMPSuggestedRepeatPktCountInfo = FOUR_CHAR_CODE('srpc'), /* UInt32* */
  1052.     kRTPMPSuggestedRepeatPktSpacingInfo = FOUR_CHAR_CODE('srps'), /* UInt32* in milliseconds */
  1053.     kRTPMPMaxPartialSampleSizeInfo = FOUR_CHAR_CODE('mpss'),    /* UInt32* in bytes */
  1054.     kRTPMPPreferredBufferDelayInfo = FOUR_CHAR_CODE('prbd'),    /* UInt32* in milliseconds */
  1055.     kRTPMPPayloadNameInfo       = FOUR_CHAR_CODE('name'),       /* StringPtr */
  1056.     kRTPInfo_FormatString       = FOUR_CHAR_CODE('fmtp')        /* char **, caller allocates ptr, callee disposes */
  1057. };
  1059. /*-----------------------------------------
  1060.     RTP Media Packetizer Characteristics
  1061. -----------------------------------------*/
  1062. /* also supports relevant ones in Movies.h and QTSToolbox.h */
  1063. enum {
  1064.     kRTPMPNoSampleDataRequiredCharacteristic = FOUR_CHAR_CODE('nsdr'),
  1065.     kRTPMPHasUserSettingsDialogCharacteristic = FOUR_CHAR_CODE('sdlg'),
  1066.     kRTPMPPrefersReliableTransportCharacteristic = FOUR_CHAR_CODE('rely'),
  1067.     kRTPMPRequiresOutOfBandDimensionsCharacteristic = FOUR_CHAR_CODE('robd'),
  1068.     kRTPMPReadsPartialSamplesCharacteristic = FOUR_CHAR_CODE('rpsp')
  1069. };
  1071. /*-----------------------------------------
  1072.     RTP Media Packetizer selectors
  1073. -----------------------------------------*/
  1074. enum {
  1075.     kRTPMPInitializeSelect      = 0x0500,
  1076.     kRTPMPPreflightMediaSelect  = 0x0501,
  1077.     kRTPMPIdleSelect            = 0x0502,
  1078.     kRTPMPSetSampleDataSelect   = 0x0503,
  1079.     kRTPMPFlushSelect           = 0x0504,
  1080.     kRTPMPResetSelect           = 0x0505,
  1081.     kRTPMPSetInfoSelect         = 0x0506,
  1082.     kRTPMPGetInfoSelect         = 0x0507,
  1083.     kRTPMPSetTimeScaleSelect    = 0x0508,
  1084.     kRTPMPGetTimeScaleSelect    = 0x0509,
  1085.     kRTPMPSetTimeBaseSelect     = 0x050A,
  1086.     kRTPMPGetTimeBaseSelect     = 0x050B,
  1087.     kRTPMPHasCharacteristicSelect = 0x050C,
  1088.     kRTPMPSetPacketBuilderSelect = 0x050E,
  1089.     kRTPMPGetPacketBuilderSelect = 0x050F,
  1090.     kRTPMPSetMediaTypeSelect    = 0x0510,
  1091.     kRTPMPGetMediaTypeSelect    = 0x0511,
  1092.     kRTPMPSetMaxPacketSizeSelect = 0x0512,
  1093.     kRTPMPGetMaxPacketSizeSelect = 0x0513,
  1094.     kRTPMPSetMaxPacketDurationSelect = 0x0514,
  1095.     kRTPMPGetMaxPacketDurationSelect = 0x0515,                  /* for export component and apps who want to*/
  1096.                                                                 /* access dialogs for Media-specific settings*/
  1097.                                                                 /* (such as Pure Voice interleave factor)*/
  1098.     kRTPMPDoUserDialogSelect    = 0x0516,
  1099.     kRTPMPSetSettingsFromAtomContainerAtAtomSelect = 0x0517,
  1100.     kRTPMPGetSettingsIntoAtomContainerAtAtomSelect = 0x0518,
  1101.     kRTPMPGetSettingsAsTextSelect = 0x0519,
  1102.     kRTPMPGetSettingsSelect     = 0x051A,
  1103.     kRTPMPSetSettingsSelect     = 0x051B
  1104. };
  1106. /*-----------------------------------------
  1107.     RTP Media Packetizer functions
  1108. -----------------------------------------*/
  1110. EXTERN_API( ComponentResult )
  1111. RTPMPInitialize                 (RTPMediaPacketizer     rtpm,
  1112.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0004, 0x0500, 0x7000, 0xA82A);
  1114. /* return noErr if you can handle this media */
  1115. EXTERN_API( ComponentResult )
  1116. RTPMPPreflightMedia             (RTPMediaPacketizer     rtpm,
  1117.                                  OSType                 inMediaType,
  1118.                                  SampleDescriptionHandle  inSampleDescription)              FIVEWORDINLINE(0x2F3C, 0x0008, 0x0501, 0x7000, 0xA82A);
  1120. /*
  1121.    do work here if you need to - give up time periodically
  1122.    if you're doing time consuming operations
  1123. */
  1124. EXTERN_API( ComponentResult )
  1125. RTPMPIdle                       (RTPMediaPacketizer     rtpm,
  1126.                                  SInt32                 inFlags,
  1127.                                  SInt32 *               outFlags)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0502, 0x7000, 0xA82A);
  1129. /*
  1130.    caller owns the RTPMPSampleDataParams struct
  1131.    media Packetizer must copy any fields of the struct it wants to keep
  1132.    media Packetizer must call release proc when done with the data
  1133.    you can do the processing work here if it does not take up too
  1134.    much cpu time - otherwise do it in idle
  1135. */
  1136. EXTERN_API( ComponentResult )
  1137. RTPMPSetSampleData              (RTPMediaPacketizer     rtpm,
  1138.                                  const RTPMPSampleDataParams * inSampleData,
  1139.                                  SInt32 *               outFlags)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0503, 0x7000, 0xA82A);
  1141. /*
  1142.    send everything you have buffered - you will get idles while
  1143.    you set the kRTPMPStillProcessingData flag here and in idle
  1144. */
  1145. EXTERN_API( ComponentResult )
  1146. RTPMPFlush                      (RTPMediaPacketizer     rtpm,
  1147.                                  SInt32                 inFlags,
  1148.                                  SInt32 *               outFlags)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0504, 0x7000, 0xA82A);
  1150. /*
  1151.    dispose of anything buffered and get rid of state
  1152.    do not send the buffered data (because presumably
  1153.    there is no connection for you to send on)
  1154.    state should be the same as if you were just initialized
  1155. */
  1156. EXTERN_API( ComponentResult )
  1157. RTPMPReset                      (RTPMediaPacketizer     rtpm,
  1158.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0004, 0x0505, 0x7000, 0xA82A);
  1160. /*-----------------------------------------
  1161.     RTP Media Packetizer get / set functions
  1162. -----------------------------------------*/
  1163. EXTERN_API( ComponentResult )
  1164. RTPMPSetInfo                    (RTPMediaPacketizer     rtpm,
  1165.                                  OSType                 inSelector,
  1166.                                  const void *           ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0506, 0x7000, 0xA82A);
  1168. EXTERN_API( ComponentResult )
  1169. RTPMPGetInfo                    (RTPMediaPacketizer     rtpm,
  1170.                                  OSType                 inSelector,
  1171.                                  void *                 ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0507, 0x7000, 0xA82A);
  1173. EXTERN_API( ComponentResult )
  1174. RTPMPSetTimeScale               (RTPMediaPacketizer     rtpm,
  1175.                                  TimeScale              inTimeScale)                        FIVEWORDINLINE(0x2F3C, 0x0004, 0x0508, 0x7000, 0xA82A);
  1177. EXTERN_API( ComponentResult )
  1178. RTPMPGetTimeScale               (RTPMediaPacketizer     rtpm,
  1179.                                  TimeScale *            outTimeScale)                       FIVEWORDINLINE(0x2F3C, 0x0004, 0x0509, 0x7000, 0xA82A);
  1181. EXTERN_API( ComponentResult )
  1182. RTPMPSetTimeBase                (RTPMediaPacketizer     rtpm,
  1183.                                  TimeBase               inTimeBase)                         FIVEWORDINLINE(0x2F3C, 0x0004, 0x050A, 0x7000, 0xA82A);
  1185. EXTERN_API( ComponentResult )
  1186. RTPMPGetTimeBase                (RTPMediaPacketizer     rtpm,
  1187.                                  TimeBase *             outTimeBase)                        FIVEWORDINLINE(0x2F3C, 0x0004, 0x050B, 0x7000, 0xA82A);
  1189. EXTERN_API( ComponentResult )
  1190. RTPMPHasCharacteristic          (RTPMediaPacketizer     rtpm,
  1191.                                  OSType                 inSelector,
  1192.                                  Boolean *              outHasIt)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x050C, 0x7000, 0xA82A);
  1194. EXTERN_API( ComponentResult )
  1195. RTPMPSetPacketBuilder           (RTPMediaPacketizer     rtpm,
  1196.                                  ComponentInstance      inPacketBuilder)                    FIVEWORDINLINE(0x2F3C, 0x0004, 0x050E, 0x7000, 0xA82A);
  1198. EXTERN_API( ComponentResult )
  1199. RTPMPGetPacketBuilder           (RTPMediaPacketizer     rtpm,
  1200.                                  ComponentInstance *    outPacketBuilder)                   FIVEWORDINLINE(0x2F3C, 0x0004, 0x050F, 0x7000, 0xA82A);
  1202. EXTERN_API( ComponentResult )
  1203. RTPMPSetMediaType               (RTPMediaPacketizer     rtpm,
  1204.                                  OSType                 inMediaType)                        FIVEWORDINLINE(0x2F3C, 0x0004, 0x0510, 0x7000, 0xA82A);
  1206. EXTERN_API( ComponentResult )
  1207. RTPMPGetMediaType               (RTPMediaPacketizer     rtpm,
  1208.                                  OSType *               outMediaType)                       FIVEWORDINLINE(0x2F3C, 0x0004, 0x0511, 0x7000, 0xA82A);
  1210. /* size is in bytes*/
  1211. EXTERN_API( ComponentResult )
  1212. RTPMPSetMaxPacketSize           (RTPMediaPacketizer     rtpm,
  1213.                                  UInt32                 inMaxPacketSize)                    FIVEWORDINLINE(0x2F3C, 0x0004, 0x0512, 0x7000, 0xA82A);
  1215. EXTERN_API( ComponentResult )
  1216. RTPMPGetMaxPacketSize           (RTPMediaPacketizer     rtpm,
  1217.                                  UInt32 *               outMaxPacketSize)                   FIVEWORDINLINE(0x2F3C, 0x0004, 0x0513, 0x7000, 0xA82A);
  1219. /* duration is in milliseconds*/
  1220. EXTERN_API( ComponentResult )
  1221. RTPMPSetMaxPacketDuration       (RTPMediaPacketizer     rtpm,
  1222.                                  UInt32                 inMaxPacketDuration)                FIVEWORDINLINE(0x2F3C, 0x0004, 0x0514, 0x7000, 0xA82A);
  1224. EXTERN_API( ComponentResult )
  1225. RTPMPGetMaxPacketDuration       (RTPMediaPacketizer     rtpm,
  1226.                                  UInt32 *               outMaxPacketDuration)               FIVEWORDINLINE(0x2F3C, 0x0004, 0x0515, 0x7000, 0xA82A);
  1228. EXTERN_API( ComponentResult )
  1229. RTPMPDoUserDialog               (RTPMediaPacketizer     rtpm,
  1230.                                  ModalFilterUPP         inFilterUPP,
  1231.                                  Boolean *              canceled)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x0516, 0x7000, 0xA82A);
  1233. EXTERN_API( ComponentResult )
  1234. RTPMPSetSettingsFromAtomContainerAtAtom (RTPMediaPacketizer  rtpm,
  1235.                                  QTAtomContainer        inContainer,
  1236.                                  QTAtom                 inParentAtom)                       FIVEWORDINLINE(0x2F3C, 0x0008, 0x0517, 0x7000, 0xA82A);
  1238. EXTERN_API( ComponentResult )
  1239. RTPMPGetSettingsIntoAtomContainerAtAtom (RTPMediaPacketizer  rtpm,
  1240.                                  QTAtomContainer        inOutContainer,
  1241.                                  QTAtom                 inParentAtom)                       FIVEWORDINLINE(0x2F3C, 0x0008, 0x0518, 0x7000, 0xA82A);
  1243. EXTERN_API( ComponentResult )
  1244. RTPMPGetSettingsAsText          (RTPMediaPacketizer     rtpm,
  1245.                                  Handle *               text)                               FIVEWORDINLINE(0x2F3C, 0x0004, 0x0519, 0x7000, 0xA82A);
  1248. EXTERN_API( ComponentResult )
  1249. RTPMPGetSettings                (RTPMediaPacketizer     rtpm,
  1250.                                  QTAtomContainer *      outSettings,
  1251.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0008, 0x051A, 0x7000, 0xA82A);
  1253. EXTERN_API( ComponentResult )
  1254. RTPMPSetSettings                (RTPMediaPacketizer     rtpm,
  1255.                                  QTAtomSpecPtr          inSettings,
  1256.                                  SInt32                 inFlags)                            FIVEWORDINLINE(0x2F3C, 0x0008, 0x051B, 0x7000, 0xA82A);
  1258. /*============================================================================
  1259.         RTP Packet Builder
  1260. ============================================================================*/
  1261. enum {
  1262.     kRTPPacketBuilderType       = FOUR_CHAR_CODE('rtpb')
  1263. };
  1266. typedef ComponentInstance               RTPPacketBuilder;
  1267. typedef struct OpaqueRTPPacketGroupRef*  RTPPacketGroupRef;
  1268. typedef struct OpaqueRTPPacketRef*      RTPPacketRef;
  1269. typedef struct OpaqueRTPPacketRepeatedDataRef*  RTPPacketRepeatedDataRef;
  1270. /* flags for RTPPBBegin/EndPacket, RTPPBBegin/EndPacketGroup*/
  1271. enum {
  1272.     kRTPPBSetMarkerFlag         = 0x00000001,
  1273.     kRTPPBRepeatPacketFlag      = 0x00000002,
  1274.     kRTPPBSyncSampleFlag        = 0x00010000,
  1275.     kRTPPBBFrameFlag            = 0x00020000,
  1276.     kRTPPBDontSendFlag          = 0x10000000                    /* when set in EndPacketGroup, will not add group*/
  1277. };
  1279. enum {
  1280.     kRTPPBUnknownPacketMediaDataLength = 0
  1281. };
  1283. /* flags for RTPPBGetSampleData*/
  1284. enum {
  1285.     kRTPPBEndOfDataFlag         = 0x00000001
  1286. };
  1289. typedef CALLBACK_API( void , RTPPBCallbackProcPtr )(OSType inSelector, void *ioParams, void *inRefCon);
  1290. typedef STACK_UPP_TYPE(RTPPBCallbackProcPtr)                    RTPPBCallbackUPP;
  1291. /*-----------------------------------------
  1292.     RTP Packet Builder selectors
  1293. -----------------------------------------*/
  1294. enum {
  1295.     kRTPPBBeginPacketGroupSelect = 0x0500,
  1296.     kRTPPBEndPacketGroupSelect  = 0x0501,
  1297.     kRTPPBBeginPacketSelect     = 0x0502,
  1298.     kRTPPBEndPacketSelect       = 0x0503,
  1299.     kRTPPBAddPacketLiteralDataSelect = 0x0504,
  1300.     kRTPPBAddPacketSampleDataSelect = 0x0505,
  1301.     kRTPPBAddPacketRepeatedDataSelect = 0x0506,
  1302.     kRTPPBReleaseRepeatedDataSelect = 0x0507,
  1303.     kRTPPBSetPacketSequenceNumberSelect = 0x0508,
  1304.     kRTPPBGetPacketSequenceNumberSelect = 0x0509,
  1305.     kRTPPBSetCallbackSelect     = 0x050A,
  1306.     kRTPPBGetCallbackSelect     = 0x050B,
  1307.     kRTPPBSetInfoSelect         = 0x050C,
  1308.     kRTPPBGetInfoSelect         = 0x050D,
  1309.     kRTPPBSetPacketTimeStampOffsetSelect = 0x050E,
  1310.     kRTPPBGetPacketTimeStampOffsetSelect = 0x050F,
  1311.     kRTPPBAddPacketSampleData64Select = 0x0510,
  1312.     kRTPPBGetSampleDataSelect   = 0x0511,
  1313.     kRTPPBAddRepeatPacketSelect = 0x0512
  1314. };
  1316. /*-----------------------------------------
  1317.     RTP Packet Builder functions
  1318. -----------------------------------------*/
  1319. EXTERN_API( ComponentResult )
  1320. RTPPBBeginPacketGroup           (RTPPacketBuilder       rtpb,
  1321.                                  SInt32                 inFlags,
  1322.                                  UInt32                 inTimeStamp,
  1323.                                  RTPPacketGroupRef *    outPacketGroup)                     FIVEWORDINLINE(0x2F3C, 0x000C, 0x0500, 0x7000, 0xA82A);
  1325. EXTERN_API( ComponentResult )
  1326. RTPPBEndPacketGroup             (RTPPacketBuilder       rtpb,
  1327.                                  SInt32                 inFlags,
  1328.                                  RTPPacketGroupRef      inPacketGroup)                      FIVEWORDINLINE(0x2F3C, 0x0008, 0x0501, 0x7000, 0xA82A);
  1330. EXTERN_API( ComponentResult )
  1331. RTPPBBeginPacket                (RTPPacketBuilder       rtpb,
  1332.                                  SInt32                 inFlags,
  1333.                                  RTPPacketGroupRef      inPacketGroup,
  1334.                                  UInt32                 inPacketMediaDataLength,
  1335.                                  RTPPacketRef *         outPacket)                          FIVEWORDINLINE(0x2F3C, 0x0010, 0x0502, 0x7000, 0xA82A);
  1337. EXTERN_API( ComponentResult )
  1338. RTPPBEndPacket                  (RTPPacketBuilder       rtpb,
  1339.                                  SInt32                 inFlags,
  1340.                                  RTPPacketGroupRef      inPacketGroup,
  1341.                                  RTPPacketRef           inPacket,
  1342.                                  UInt32                 inTransmissionTimeOffset,
  1343.                                  UInt32                 inDuration)                         FIVEWORDINLINE(0x2F3C, 0x0014, 0x0503, 0x7000, 0xA82A);
  1345. /*
  1346.    non-NULL RTPPacketRepeatedDataRef means this data will be repeated later
  1347.    pb must return a repeated data ref
  1348. */
  1349. EXTERN_API( ComponentResult )
  1350. RTPPBAddPacketLiteralData       (RTPPacketBuilder       rtpb,
  1351.                                  SInt32                 inFlags,
  1352.                                  RTPPacketGroupRef      inPacketGroup,
  1353.                                  RTPPacketRef           inPacket,
  1354.                                  UInt8 *                inData,
  1355.                                  UInt32                 inDataLength,
  1356.                                  RTPPacketRepeatedDataRef * outDataRef)                     FIVEWORDINLINE(0x2F3C, 0x0018, 0x0504, 0x7000, 0xA82A);
  1358. /*
  1359.    non-NULL RTPPacketRepeatedDataRef means this data will be repeated later
  1360.    pb must return a repeated data ref
  1361. */
  1362. EXTERN_API( ComponentResult )
  1363. RTPPBAddPacketSampleData        (RTPPacketBuilder       rtpb,
  1364.                                  SInt32                 inFlags,
  1365.                                  RTPPacketGroupRef      inPacketGroup,
  1366.                                  RTPPacketRef           inPacket,
  1367.                                  RTPMPSampleDataParams * inSampleDataParams,
  1368.                                  UInt32                 inSampleOffset,
  1369.                                  UInt32                 inSampleDataLength,
  1370.                                  RTPPacketRepeatedDataRef * outDataRef)                     FIVEWORDINLINE(0x2F3C, 0x001C, 0x0505, 0x7000, 0xA82A);
  1372. /*
  1373.    non-NULL RTPPacketRepeatedDataRef means this data will be repeated later
  1374.    pb must return a repeated data ref
  1375. */
  1376. EXTERN_API( ComponentResult )
  1377. RTPPBAddPacketSampleData64      (RTPPacketBuilder       rtpb,
  1378.                                  SInt32                 inFlags,
  1379.                                  RTPPacketGroupRef      inPacketGroup,
  1380.                                  RTPPacketRef           inPacket,
  1381.                                  RTPMPSampleDataParams * inSampleDataParams,
  1382.                                  const UInt64 *         inSampleOffset,
  1383.                                  UInt32                 inSampleDataLength,
  1384.                                  RTPPacketRepeatedDataRef * outDataRef)                     FIVEWORDINLINE(0x2F3C, 0x001C, 0x0510, 0x7000, 0xA82A);
  1386. /*
  1387.    call to add the repeated data using the ref you got from
  1388.    RTPPBAddPacketLiteralData or RTPPBAddPacketSampleData
  1389. */
  1390. EXTERN_API( ComponentResult )
  1391. RTPPBAddPacketRepeatedData      (RTPPacketBuilder       rtpb,
  1392.                                  SInt32                 inFlags,
  1393.                                  RTPPacketGroupRef      inPacketGroup,
  1394.                                  RTPPacketRef           inPacket,
  1395.                                  RTPPacketRepeatedDataRef  inDataRef)                       FIVEWORDINLINE(0x2F3C, 0x0010, 0x0506, 0x7000, 0xA82A);
  1397. /* call when done with repeated data*/
  1398. EXTERN_API( ComponentResult )
  1399. RTPPBReleaseRepeatedData        (RTPPacketBuilder       rtpb,
  1400.                                  RTPPacketRepeatedDataRef  inDataRef)                       FIVEWORDINLINE(0x2F3C, 0x0004, 0x0507, 0x7000, 0xA82A);
  1402. /*
  1403.    seq number is just relative seq number
  1404.    don't call if you don't care when seq # is used
  1405. */
  1406. EXTERN_API( ComponentResult )
  1407. RTPPBSetPacketSequenceNumber    (RTPPacketBuilder       rtpb,
  1408.                                  SInt32                 inFlags,
  1409.                                  RTPPacketGroupRef      inPacketGroup,
  1410.                                  RTPPacketRef           inPacket,
  1411.                                  UInt32                 inSequenceNumber)                   FIVEWORDINLINE(0x2F3C, 0x0010, 0x0508, 0x7000, 0xA82A);
  1413. EXTERN_API( ComponentResult )
  1414. RTPPBGetPacketSequenceNumber    (RTPPacketBuilder       rtpb,
  1415.                                  SInt32                 inFlags,
  1416.                                  RTPPacketGroupRef      inPacketGroup,
  1417.                                  RTPPacketRef           inPacket,
  1418.                                  UInt32 *               outSequenceNumber)                  FIVEWORDINLINE(0x2F3C, 0x0010, 0x0509, 0x7000, 0xA82A);
  1420. EXTERN_API( ComponentResult )
  1421. RTPPBSetPacketTimeStampOffset   (RTPPacketBuilder       rtpb,
  1422.                                  SInt32                 inFlags,
  1423.                                  RTPPacketGroupRef      inPacketGroup,
  1424.                                  RTPPacketRef           inPacket,
  1425.                                  SInt32                 inTimeStampOffset)                  FIVEWORDINLINE(0x2F3C, 0x0010, 0x050E, 0x7000, 0xA82A);
  1427. EXTERN_API( ComponentResult )
  1428. RTPPBGetPacketTimeStampOffset   (RTPPacketBuilder       rtpb,
  1429.                                  SInt32                 inFlags,
  1430.                                  RTPPacketGroupRef      inPacketGroup,
  1431.                                  RTPPacketRef           inPacket,
  1432.                                  SInt32 *               outTimeStampOffset)                 FIVEWORDINLINE(0x2F3C, 0x0010, 0x050F, 0x7000, 0xA82A);
  1434. EXTERN_API( ComponentResult )
  1435. RTPPBAddRepeatPacket            (RTPPacketBuilder       rtpb,
  1436.                                  SInt32                 inFlags,
  1437.                                  RTPPacketGroupRef      inPacketGroup,
  1438.                                  RTPPacketRef           inPacket,
  1439.                                  TimeValue              inTransmissionOffset,
  1440.                                  UInt32                 inSequenceNumber)                   FIVEWORDINLINE(0x2F3C, 0x0014, 0x0512, 0x7000, 0xA82A);
  1442. /*
  1443.    used for communicating with the caller of the media packetizers if needed
  1444.    NOT used for communicating with the media packetizers themselves
  1445. */
  1446. EXTERN_API( ComponentResult )
  1447. RTPPBSetCallback                (RTPPacketBuilder       rtpb,
  1448.                                  RTPPBCallbackUPP       inCallback,
  1449.                                  void *                 inRefCon)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x050A, 0x7000, 0xA82A);
  1451. EXTERN_API( ComponentResult )
  1452. RTPPBGetCallback                (RTPPacketBuilder       rtpb,
  1453.                                  RTPPBCallbackUPP *     outCallback,
  1454.                                  void **                outRefCon)                          FIVEWORDINLINE(0x2F3C, 0x0008, 0x050B, 0x7000, 0xA82A);
  1456. EXTERN_API( ComponentResult )
  1457. RTPPBSetInfo                    (RTPPacketBuilder       rtpb,
  1458.                                  OSType                 inSelector,
  1459.                                  void *                 ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x050C, 0x7000, 0xA82A);
  1461. EXTERN_API( ComponentResult )
  1462. RTPPBGetInfo                    (RTPPacketBuilder       rtpb,
  1463.                                  OSType                 inSelector,
  1464.                                  void *                 ioParams)                           FIVEWORDINLINE(0x2F3C, 0x0008, 0x050D, 0x7000, 0xA82A);
  1466. EXTERN_API( ComponentResult )
  1467. RTPPBGetSampleData              (RTPPacketBuilder       rtpb,
  1468.                                  RTPMPSampleDataParams * inParams,
  1469.                                  const UInt64 *         inStartOffset,
  1470.                                  UInt8 *                outDataBuffer,
  1471.                                  UInt32                 inBytesToRead,
  1472.                                  UInt32 *               outBytesRead,
  1473.                                  SInt32 *               outFlags)                           FIVEWORDINLINE(0x2F3C, 0x0018, 0x0511, 0x7000, 0xA82A);
  1476. /* UPP call backs */
  1477. #if OPAQUE_UPP_TYPES
  1478.     EXTERN_API(RTPMPDataReleaseUPP)
  1479.     NewRTPMPDataReleaseUPP         (RTPMPDataReleaseProcPtr userRoutine);
  1481.     EXTERN_API(RTPPBCallbackUPP)
  1482.     NewRTPPBCallbackUPP            (RTPPBCallbackProcPtr    userRoutine);
  1484.     EXTERN_API(void)
  1485.     DisposeRTPMPDataReleaseUPP     (RTPMPDataReleaseUPP     userUPP);
  1487.     EXTERN_API(void)
  1488.     DisposeRTPPBCallbackUPP        (RTPPBCallbackUPP        userUPP);
  1490.     EXTERN_API(void)
  1491.     InvokeRTPMPDataReleaseUPP      (UInt8 *                 inData,
  1492.                                     void *                  inRefCon,
  1493.                                     RTPMPDataReleaseUPP     userUPP);
  1495.     EXTERN_API(void)
  1496.     InvokeRTPPBCallbackUPP         (OSType                  inSelector,
  1497.                                     void *                  ioParams,
  1498.                                     void *                  inRefCon,
  1499.                                     RTPPBCallbackUPP        userUPP);
  1501. #else
  1502.     enum { uppRTPMPDataReleaseProcInfo = 0x000003C0 };              /* pascal no_return_value Func(4_bytes, 4_bytes) */
  1503.     enum { uppRTPPBCallbackProcInfo = 0x00000FC0 };                 /* pascal no_return_value Func(4_bytes, 4_bytes, 4_bytes) */
  1504.     #define NewRTPMPDataReleaseUPP(userRoutine)                     (RTPMPDataReleaseUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppRTPMPDataReleaseProcInfo, GetCurrentArchitecture())
  1505.     #define NewRTPPBCallbackUPP(userRoutine)                        (RTPPBCallbackUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppRTPPBCallbackProcInfo, GetCurrentArchitecture())
  1506.     #define DisposeRTPMPDataReleaseUPP(userUPP)                     DisposeRoutineDescriptor(userUPP)
  1507.     #define DisposeRTPPBCallbackUPP(userUPP)                        DisposeRoutineDescriptor(userUPP)
  1508.     #define InvokeRTPMPDataReleaseUPP(inData, inRefCon, userUPP)    CALL_TWO_PARAMETER_UPP((userUPP), uppRTPMPDataReleaseProcInfo, (inData), (inRefCon))
  1509.     #define InvokeRTPPBCallbackUPP(inSelector, ioParams, inRefCon, userUPP)  CALL_THREE_PARAMETER_UPP((userUPP), uppRTPPBCallbackProcInfo, (inSelector), (ioParams), (inRefCon))
  1510. #endif
  1511. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  1512. #define NewRTPMPDataReleaseProc(userRoutine)                    NewRTPMPDataReleaseUPP(userRoutine)
  1513. #define NewRTPPBCallbackProc(userRoutine)                       NewRTPPBCallbackUPP(userRoutine)
  1514. #define CallRTPMPDataReleaseProc(userRoutine, inData, inRefCon) InvokeRTPMPDataReleaseUPP(inData, inRefCon, userRoutine)
  1515. #define CallRTPPBCallbackProc(userRoutine, inSelector, ioParams, inRefCon) InvokeRTPPBCallbackUPP(inSelector, ioParams, inRefCon, userRoutine)
  1517. #if PRAGMA_STRUCT_ALIGN
  1518.     #pragma options align=reset
  1519. #elif PRAGMA_STRUCT_PACKPUSH
  1520.     #pragma pack(pop)
  1521. #elif PRAGMA_STRUCT_PACK
  1522.     #pragma pack()
  1523. #endif
  1525. #ifdef PRAGMA_IMPORT_OFF
  1526. #pragma import off
  1527. #elif PRAGMA_IMPORT
  1528. #pragma import reset
  1529. #endif
  1531. #ifdef __cplusplus
  1532. }
  1533. #endif
  1535. #endif /* __QTSTREAMINGCOMPONENTS__ */