Important: Apple recommends that developers explore QTKit and Core Video for new development in this technology area. See QTKit Framework Reference and Core Video Programming Guide for more information.
| Framework | Frameworks/QuickTime.framework |
| Declared in | ImageCompression.h Movies.h QTSMovie.h QTStreamingComponents.h QuickTimeStreaming.h |
Important: Apple recommends that developers explore QTKit and Core Video for new development in this technology area. See QTKit Framework Reference and Core Video Programming Guide for more information.
The streaming API in QuickTime allows developers to recognize and play streaming movies, add hint tracks so movies can be streamed, create packetizers and reassemblers, mix streaming and nonstreaming data in a single movie, and broadcast live streams in real time.
Disposes of a QTSModalFilterUPP pointer.
void DisposeQTSModalFilterUPP ( QTSModalFilterUPP userUPP );
A QTSModalFilterUPP pointer.
Introduced in QuickTime 5.
QuickTimeStreaming.hDisposes of a QTSNotificationUPP pointer.
void DisposeQTSNotificationUPP ( QTSNotificationUPP userUPP );
A QTSNotificationUPP pointer. See Universal Procedure Pointers.
You can access this function's error returns through GetMoviesError and GetMoviesStickyError.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hDisposes of a QTSPanelFilterUPP pointer.
void DisposeQTSPanelFilterUPP ( QTSPanelFilterUPP userUPP );
A QTSPanelFilterUPP pointer.
Introduced in QuickTime 5.
QuickTimeStreaming.hDisposes of an RTPMPDataReleaseUPP pointer.
void DisposeRTPMPDataReleaseUPP ( RTPMPDataReleaseUPP userUPP );
An RTPMPDataReleaseUPP pointer. See Universal Procedure Pointers.
You can access this function's error returns through GetMoviesError and GetMoviesStickyError.
Introduced in QuickTime 4.1.
QTStreamingComponents.hDisposes of an RTPPBCallbackUPP pointer.
void DisposeRTPPBCallbackUPP ( RTPPBCallbackUPP userUPP );
An RTPPBCallbackUPP pointer. See Universal Procedure Pointers.
You can access this function's error returns through GetMoviesError and GetMoviesStickyError.
Introduced in QuickTime 4.1.
QTStreamingComponents.hInitializes QuickTime streaming.
OSErr InitializeQTS ( void );
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hAllocates a Universal Procedure Pointer for the QTSModalFilterProc callback.
QTSModalFilterUPP NewQTSModalFilterUPP ( QTSModalFilterProcPtr userRoutine );
A pointer to your application-defined function.
A new UPP; see Universal Procedure Pointers.
Introduced in QuickTime 5.
QuickTimeStreaming.hAllocates a Universal Procedure Pointer for the QTSNotificationProc callback.
QTSNotificationUPP NewQTSNotificationUPP ( QTSNotificationProcPtr userRoutine );
A pointer to your application-defined function.
A new UPP; see Universal Procedure Pointers.
This function is used with Macintosh PowerPC systems. See Inside Macintosh: PowerPC System Software.
Introduced in QuickTime 4.1. Replaces NewQTSNotificationProc.
QuickTimeStreaming.hAllocates a Universal Procedure Pointer for the QTSPanelFilterProc callback.
QTSPanelFilterUPP NewQTSPanelFilterUPP ( QTSPanelFilterProcPtr userRoutine );
A pointer to your application-defined function.
A new UPP; see Universal Procedure Pointers.
Introduced in QuickTime 5.
QuickTimeStreaming.hAllocates a Universal Procedure Pointer for the RTPMPDataReleaseProc callback.
RTPMPDataReleaseUPP NewRTPMPDataReleaseUPP ( RTPMPDataReleaseProcPtr userRoutine );
A pointer to your application-defined function.
A new UPP; see Universal Procedure Pointers.
This function is used with Macintosh PowerPC systems. See Inside Macintosh: PowerPC System Software.
Introduced in QuickTime 4.1. Replaces NewRTPMPDataReleaseProc.
QTStreamingComponents.hAllocates a Universal Procedure Pointer for the RTPPBCallbackProc callback.
RTPPBCallbackUPP NewRTPPBCallbackUPP ( RTPPBCallbackProcPtr userRoutine );
A pointer to your application-defined function.
A new UPP; see Universal Procedure Pointers.
This function is used with Macintosh PowerPC systems. See Inside Macintosh: PowerPC System Software.
Introduced in QuickTime 4.1. Replaces NewRTPPBCallbackProc.
QTStreamingComponents.hAllocates a QuickTime streaming stream buffer.
QTSStreamBuffer * QTSAllocBuffer ( SInt32 inSize );
The size of the buffer to be allocated.
A QTSStreamBuffer structure
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
QTSMemPtr QTSAllocMemPtr ( UInt32 inByteCount, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
QTSStreamBuffer * QTSCopyMessage ( QTSStreamBuffer *inMessage );
A pointer to a QTSStreamBuffer structure.
A pointer to a QTSStreamBuffer structure.
Introduced in QuickTime 4.
QuickTimeStreaming.hDisposes of a QuickTime streaming presentation.
OSErr QTSDisposePresentation ( QTSPresentation inPresentation, SInt32 inFlags );
A pointer to a QTSPresentationRecord structure that defines the presentation to be disposed.
Flags governing the disposal of the presentation. Currently, no flags are defined; set this parameter to 0.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hDisposes of a QuickTime streaming statistics helper that was previously created by QTSNewStatHelper.
OSErr QTSDisposeStatHelper ( QTSStatHelper inStatHelper );
A pointer to a QTSStatHelperRecord structure that defines the statistics helper to be disposed.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hDisposes of a QuickTime streaming stream.
OSErr QTSDisposeStream ( QTSStream inStream, SInt32 inFlags );
A pointer to a QTSStreamRecord structure that defines a stream to be disposed.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSDuplicateMessage ( QTSStreamBuffer *inMessage, SInt32 inFlags, QTSStreamBuffer **outDuplicatedMessage );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
QTSStreamBuffer * QTSDupMessage ( QTSStreamBuffer *inMessage );
A pointer to a QTSStreamBuffer structure.
A pointer to a QTSStreamBuffer structure.
Introduced in QuickTime 4.
QuickTimeStreaming.hCreates a list of media packetizers that can work with a specified sample description and meet specified criteria.
OSErr QTSFindMediaPacketizer ( MediaPacketizerRequirementsPtr inPacketizerinfo, SampleDescriptionHandle inSampleDescription, RTPPayloadSortRequestPtr inSortInfo, QTAtomContainer *outPacketizerList );
A pointer to a MediaPacketizerRequirements structure that specifies the required features of the media packetizers you are looking for.
A handle to a SampleDescription structure that specifies the media data the packetizer needs to work with.
A pointer to a RTPPayloadSortRequest structure that specifies the sort order for the list of packetizers.
On entry, a pointer to a handle to a QT atom container. On return, this container will be filled with a sorted list of available media packetizers that meet the specified criteria. Only packetizers that have the features specified by inPacketizerInfo will be listed. The list will be sorted in the order specified by inSortInfo.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hCreates a list of media packetizers for a specified payload number.
OSErr QTSFindMediaPacketizerForPayloadID ( long payloadID, RTPPayloadSortRequestPtr inSortInfo, QTAtomContainer *outPacketizerList );
An IETF payload number.
A pointer to a RTPPayloadSortRequest structure that specifies the sort order for the list of packetizers.
On entry, a pointer to a handle to a QT atom container. On return, this container will be filled with a sorted list of available media packetizers for the specified payload ID. The list will be sorted in the order specified by inSortInfo.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hCreates a list of media packetizers for a specified payload name.
OSErr QTSFindMediaPacketizerForPayloadName ( const char *payloadName, RTPPayloadSortRequestPtr inSortInfo, QTAtomContainer *outPacketizerList );
A pointer to a payload name string.
A pointer to a RTPPayloadSortRequest structure that specifies the sort order for the list of packetizers.
On entry, a pointer to a handle to a QT atom container. On return, this container will be filled with a sorted list of available media packetizers for the specified payload name. The list will be sorted in the order specified by inSortInfo.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hCreates a list of media packetizers for a specified movie track and sample data.
OSErr QTSFindMediaPacketizerForTrack ( Track inTrack, long inSampleDescriptionIndex, RTPPayloadSortRequestPtr inSortInfo, QTAtomContainer *outPacketizerList );
The track for this operation. Your application obtains this track identifier from such functions as NewMovieTrack and GetMovieTrack.
The value of the dataRefIndex field of the SampleDescription structure that specifies the type of media data that will be packetized.
A pointer to a RTPPayloadSortRequest structure that specifies the sort order for the list of packetizers.
On entry, a pointer to a handle to a QT atom container. On return, this container will be filled with a sorted list of available media packetizers for the specified track. The list will be sorted in the order specified by inSortInfo.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hCreates a list of streaming reassemblers for a specified payload number.
OSErr QTSFindReassemblerForPayloadID ( UInt8 inPayloadID, RTPPayloadSortRequest *inSortInfo, QTAtomContainer *outReassemblerList );
An IETF payload number.
A pointer to a RTPPayloadSortRequest structure that specifies the sort order for the list of reassemblers.
On entry, a pointer to a handle to a QT atom container. On return, this container will be filled with a sorted list of available reassemblers for the specified track. The list will be sorted in the order specified by inSortInfo.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hCreates a list of streaming reassemblers for a specified payload name.
OSErr QTSFindReassemblerForPayloadName ( const char *inPayloadName, RTPPayloadSortRequest *inSortInfo, QTAtomContainer *outReassemblerList );
A payload name string.
A pointer to a RTPPayloadSortRequest structure that specifies the sort order for the list of reassemblers.
On entry, a pointer to a handle to a QT atom container. On return, this container will be filled with a sorted list of available reassemblers for the specified track. The list will be sorted in the order specified by inSortInfo.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hUndocumented
QTSStreamBuffer * QTSFlattenMessage ( QTSStreamBuffer *inMessage );
A pointer to a QTSStreamBuffer structure.
A pointer to a QTSStreamBuffer structure.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
void QTSFreeMessage ( QTSStreamBuffer *inMessage );
A pointer to a QTSStreamBuffer structure.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
Boolean QTSGetErrorString ( SInt32 inErrorCode, UInt32 inMaxErrorStringLength, char *outErrorString, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the name of a streaming network application.
OSErr QTSGetNetworkAppName ( SInt32 inFlags, char **outCStringPtr );
A flag (see below) that determines whether the application name is a full pathname. See these constants:
kQTSNetworkAppNameIsFullNameFlag
A Ptr to a CStringPtr; see MacTypes.h. This information is sent back to servers in HTTP and RTSP headers, so they can work out client statistics. A typical default string is QTS (qtver=4.1.1;cpu=PPC;os=Mac 9.0.4).
See Error Codes. Returns noErr if there is no error.
Following is an example of calling this function:
Ptr networkAppName =NIL; |
err =QTSGetNetworkAppName(0L, &networkAppName); |
printf("The NetworkAppName is %s", networkAppName); |
DisposePtr(networkAppName); |
// This call prints |
// The NetworkAppName is QTS (qtver=4.1.1;cpu=PPC;os=Mac 9.0.4) |
// or |
// The NetworkAppName is QTS (qtver=4.0;os=Windows NT 4.0 Service Pack 3) |
// If you set it from your app, that will be returned instead. |
Introduced in QuickTime 4.1.
QuickTimeStreaming.hGets the statistics atom for a stream or creates a new statistics atom for it.
OSErr QTSGetOrMakeStatAtomForStream ( QTAtomContainer inContainer, QTSStream inStream, QTAtom *outParentAtom );
An atom container that holds the statistics atoms for the specified stream.
A pointer to a QTSStreamRecord structure that defines a stream.
On entry, a pointer to a variable of type QTAtom; on return, this variable is set to the atom that holds the statistics for this stream. If no such atom exists for that stream, then the function creates a statistics atom.
See Error Codes. Returns noErr if there is no error.
This function is to be used only by stream components to put stream statistics into an atom container; applications should not call it.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the presentation for a stream.
QTSPresentation QTSGetStreamPresentation ( QTSStream inStream );
A pointer to a QTSStreamRecord structure that defines a stream.
A pointer to a QTSPresentationRecord structure.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSInitializeMediaParams ( QTSMediaParams *inMediaParams );
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hInserts statistics data into the statistic atom for a stream.
OSErr QTSInsertStatistic ( QTAtomContainer inContainer, QTAtom inParentAtom, OSType inStatType, void *inStatData, UInt32 inStatDataLength, OSType inStatDataFormat, SInt32 inFlags );
A handle to the atom container that contains the statistic atom.
The atom that will hold a new atom containing the specified statistic data.
A constant (see below) that identifies the type of statistic atom to insert the data into. See these constants:
kQTSStatisticsStreamAtomType
kQTSStatisticsNameAtomType
kQTSStatisticsDataFormatAtomType
kQTSStatisticsDataAtomType
kQTSStatisticsUnitsAtomType
kQTSStatisticsUnitsNameAtomType
A pointer to a structure containing the data to insert.
The length, in bytes, of the statistic data.
A constant (see below) that identifies the format of the inserted statistic atom. See these constants:
kQTSStatisticsSInt32DataFormat
kQTSStatisticsUInt32DataFormat
kQTSStatisticsSInt16DataFormat
kQTSStatisticsUInt16DataFormat
kQTSStatisticsFixedDataFormat
kQTSStatisticsStringDataFormat
kQTSStatisticsOSTypeDataFormat
Currently no flags are defined; pass 0 in this parameter.
See Error Codes. Returns noErr if there is no error.
This function is to be used only by stream components to put stream statistics into an atom container; applications should not call it.
Introduced in QuickTime 4.
QuickTimeStreaming.hInserts the name and type of a statistic datum into the statistic atom for a stream.
OSErr QTSInsertStatisticName ( QTAtomContainer inContainer, QTAtom inParentAtom, OSType inStatType, const char *inStatName, UInt32 inStatNameLength );
A handle to the atom container that contains the statistic atom. Both the atom container and the parent atom must already exist.
The atom that will hold a new atom containing the specified statistic name and type.
A constant (see below) that identifies the type of statistic atom to insert the data into. See these constants:
kQTSStatisticsStreamAtomType
kQTSStatisticsNameAtomType
kQTSStatisticsDataFormatAtomType
kQTSStatisticsDataAtomType
kQTSStatisticsUnitsAtomType
kQTSStatisticsUnitsNameAtomType
A pointer to the name string to be inserted.
The length of the name string in characters.
See Error Codes. Returns noErr if there is no error.
This function is to be used only by stream components to put stream statistics into an atom container; applications should not call it.
Introduced in QuickTime 4.
QuickTimeStreaming.hInserts the name and type of statistic units into the statistic atom for a stream.
OSErr QTSInsertStatisticUnits ( QTAtomContainer inContainer, QTAtom inParentAtom, OSType inStatType, OSType inUnitsType, const char *inUnitsName, UInt32 inUnitsNameLength );
A handle to the atom container that contains the statistic atom. Both the atom container and the parent atom must already exist.
The atom that will hold a new atom containing the specified statistic name and type.
A constant (see below) that identifies the type of statistic atom to insert the data into. See these constants:
kQTSStatisticsStreamAtomType
kQTSStatisticsNameAtomType
kQTSStatisticsDataFormatAtomType
kQTSStatisticsDataAtomType
kQTSStatisticsUnitsAtomType
kQTSStatisticsUnitsNameAtomType
A constant (see below) that identifies the type of units atom to insert the data into. See these constants:
kQTSStatisticsNoUnitsType
kQTSStatisticsPercentUnitsType
kQTSStatisticsBitsPerSecUnitsType
kQTSStatisticsFramesPerSecUnitsType
A pointer to the units name string to be inserted.
The length of the units name string in characters.
See Error Codes. Returns noErr if there is no error.
This function is to be used only by stream components to put stream statistics into an atom container; applications should not call it.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
ComponentResult QTSMediaGetIndStreamInfo ( MediaHandler mh, SInt32 inIndex, OSType inSelector, void *ioParams );
A media handler. You can obtain this reference from GetMediaHandler.
Undocumented
A constant (see below) that identifies the type of information to be retrieved. See these constants:
kQTSMediaPresentationInfo
kQTSMediaNotificationInfo
kQTSMediaTotalDataRateInfo
kQTSMediaLostPercentInfo
kQTSMediaNumStreamsInfo
kQTSMediaIndSampleDescriptionInfo
A pointer to returned information in a format determined by inSelector (see below).
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTSMovie.hGets information about a streaming media.
ComponentResult QTSMediaGetInfo ( MediaHandler mh, OSType inSelector, void *ioParams );
A media handler. You can obtain this reference from GetMediaHandler.
A constant (see below) that identifies the type of information to be retrieved. See these constants:
kQTSMediaPresentationInfo
kQTSMediaNotificationInfo
kQTSMediaTotalDataRateInfo
kQTSMediaLostPercentInfo
kQTSMediaNumStreamsInfo
kQTSMediaIndSampleDescriptionInfo
A pointer to returned information in a format determined by inSelector (see below).
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTSMovie.hUndocumented
ComponentResult QTSMediaSetIndStreamInfo ( MediaHandler mh, SInt32 inIndex, OSType inSelector, void *ioParams );
A media handler. You can obtain this reference from GetMediaHandler.
Undocumented
A constant (see below) that identifies the type of information to be set. See these constants:
kQTSMediaPresentationInfo
kQTSMediaNotificationInfo
kQTSMediaTotalDataRateInfo
kQTSMediaLostPercentInfo
kQTSMediaNumStreamsInfo
kQTSMediaIndSampleDescriptionInfo
A pointer to information in a format determined by inSelector (see below).
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTSMovie.hSets information about a streaming media.
ComponentResult QTSMediaSetInfo ( MediaHandler mh, OSType inSelector, void *ioParams );
A media handler. You can obtain this reference from GetMediaHandler.
A constant (see below) that identifies the type of information to be set. See these constants:
kQTSMediaPresentationInfo
kQTSMediaNotificationInfo
kQTSMediaTotalDataRateInfo
kQTSMediaLostPercentInfo
kQTSMediaNumStreamsInfo
kQTSMediaIndSampleDescriptionInfo
A pointer to information in a format determined by inSelector (see below).
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTSMovie.hUndocumented
UInt32 QTSMessageLength ( QTSStreamBuffer *inMessage );
A pointer to a QTSStreamBuffer structure.
The message length.
Introduced in QuickTime 4.
QuickTimeStreaming.hAllocates a new handle for data, with options and checking.
Handle QTSNewHandle ( UInt32 inByteCount, SInt32 inFlags, SInt32 *outFlags );
The requested size in bytes of the relocatable block.
Flags (see below) that control memory allocation options. See these constants:
kQTSMemAllocClearMem
kQTSMemAllocDontUseTempMem
kQTSMemAllocTryTempMemFirst
kQTSMemAllocDontUseSystemMem
kQTSMemAllocTrySystemMemFirst
kQTSMemAllocHoldMemory
kQTSMemAllocIsInterruptTime
A pointer to memory where return flags (see below) report on the block's actual memory location. See these constants:
kQTSMemAllocAllocatedInTempMem
kQTSMemAllocAllocatedInSystemMem
The new handle.
This function is a handy way to allocate memory without overflowing the application heap, which is mostly a concern with Mac OS versions 7 through 9. It is often used for streaming data.
Introduced in QuickTime 4.
QuickTimeStreaming.hCreates a new streaming presentation.
OSErr QTSNewPresentation ( const QTSNewPresentationParams *inParams, QTSPresentation *outPresentation );
A pointer to a QTSNewPresentationParams structure that specifies the presentation.
A pointer to a pointer to a new QTSPresentationRecord structure.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSNewPresentationFromData ( OSType inDataType, const void *inData, const SInt64 *inDataLength, const QTSPresParams *inPresParams, QTSPresentation *outPresentation );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSNewPresentationFromDataRef ( Handle inDataRef, OSType inDataRefType, const QTSPresParams *inPresParams, QTSPresentation *outPresentation );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSNewPresentationFromFile ( const FSSpec *inFileSpec, const QTSPresParams *inPresParams, QTSPresentation *outPresentation );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hAllocates a block of memory for streaming data, with options and checking, and returns a pointer to it.
Ptr QTSNewPtr ( UInt32 inByteCount, SInt32 inFlags, SInt32 *outFlags );
The requested size in bytes of the new memory block.
Flags (see below) that control memory allocation options. See these constants:
kQTSMemAllocClearMem
kQTSMemAllocDontUseTempMem
kQTSMemAllocTryTempMemFirst
kQTSMemAllocDontUseSystemMem
kQTSMemAllocTrySystemMemFirst
kQTSMemAllocHoldMemory
kQTSMemAllocIsInterruptTime
A pointer to memory where return flags (see below) report on the block's actual memory location. See these constants:
kQTSMemAllocAllocatedInTempMem
kQTSMemAllocAllocatedInSystemMem
A pointer to the newly allocated block.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSNewSourcer ( void *params, const QTSSourcerInitParams *inInitParams, SInt32 inFlags, ComponentInstance *outSourcer );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hCreates a new statistics helper for a stream or presentation.
OSErr QTSNewStatHelper ( QTSPresentation inPresentation, QTSStream inStream, OSType inStatType, SInt32 inFlags, QTSStatHelper *outStatHelper );
A pointer to a QTSPresentationRecord structure that defines the presentation to keep statistics on. To create a statistics helper for a particular stream, pass in kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines the stream to keep statistics on. To create a statistics helper for a whole presentation, pass in kQTSAllStreams.
A constant (see below) that defines the type of statistic you want the statistics helper to gather. See these constants:
kQTSAllStatisticsType
kQTSShortStatisticsType
kQTSSummaryStatisticsType
Constants (see below) governing the action of the statistics helper. See these constants:
kQTSGetNameStatisticsFlag
kQTSDontGetDataStatisticsFlag
kQTSUpdateAtomsStatisticsFlag
kQTSGetUnitsStatisticsFlag
On entry, a pointer to a variable of type QTSStatHelper; on return, this variable is set to the new statistics helper.
See Error Codes. Returns noErr if there is no error.
A statistics helper is a set of utility functions that you can use to retrieve and parse statistics from a stream component. You need to instantiate a statistics helper for every stream from which you want to gather statistics.
When you are done using the statistics helper, call QTSDisposeStatHelper.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSNewStreamBuffer ( UInt32 inDataSize, SInt32 inFlags, QTSStreamBuffer **outStreamBuffer );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsAddConnectionSetting ( OSType protocol, SInt32 portID, UInt32 flags, UInt32 seed );
A constant (see below) that identifies the connection protocol. See these constants:
kQTSDirectConnectHTTPProtocol
kQTSDirectConnectRTSPProtocol
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsAddProxySetting ( OSType proxyType, SInt32 portID, UInt32 flags, UInt32 seed, Str255 srvrURL );
A constant (see below) that defines the proxy type. See these constants:
kQTSHTTPProxyPrefsType
kQTSRTSPProxyPrefsType
kQTSSOCKSProxyPrefsType
kQTSDontProxyDataType
Undocumented
Undocumented
Undocumented
A string containing the server's URL.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsAddProxyUserInfo ( OSType proxyType, SInt32 flags, SInt32 flagsMask, StringPtr username, StringPtr password );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsFindConnectionByType ( OSType protocol, UInt32 flags, UInt32 flagsMask, QTSTransportPref **connectionHndl, SInt16 *count );
A constant (see below) that identifies the connection protocol. See these constants:
kQTSDirectConnectHTTPProtocol
kQTSDirectConnectRTSPProtocol
Undocumented
Undocumented
A handle to a QTSTransportPref structure.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsFindProxyByType ( OSType proxyType, UInt32 flags, UInt32 flagsMask, QTSProxyPref **proxyHndl, SInt16 *count );
A constant (see below) that defines the proxy type. See these constants:
kQTSHTTPProxyPrefsType
kQTSRTSPProxyPrefsType
kQTSSOCKSProxyPrefsType
kQTSDontProxyDataType
Undocumented
Undocumented
A handle to a QTSProxyPref structure.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsFindProxyUserInfoByType ( OSType proxyType, SInt32 flags, SInt32 flagsMask, StringPtr username, StringPtr password );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsGetActiveConnection ( OSType protocol, QTSTransportPref *connectInfo );
A constant (see below) that identifies the connection protocol. See these constants:
kQTSDirectConnectHTTPProtocol
kQTSDirectConnectRTSPProtocol
A pointer to a QTSTransportPref structure.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsGetInstantOnSettings ( QTSInstantOnPref *outPref, SInt32 inFlags );
A pointer to a QTSInstantOnPref data structure.
Undocumented
You can access Movie Toolbox error returns through GetMoviesError and GetMoviesStickyError, as well as in the function result. See Error Codes.
Introduced in QuickTime 6.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsGetNoProxyURLs ( QTSNoProxyPref **noProxyHndl );
A handle to a QTSNoProxyPref structure.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsSetInstantOnSettings ( QTSInstantOnPref *inPref, SInt32 inFlags );
A pointer to a QTSInstantOnPref data structure.
Undocumented
You can access Movie Toolbox error returns through GetMoviesError and GetMoviesStickyError, as well as in the function result. See Error Codes.
Introduced in QuickTime 6.
QuickTimeStreaming.hUndocumented
OSErr QTSPrefsSetNoProxyURLs ( char *urls, UInt32 flags, UInt32 seed );
A pointer to URL strings.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPresAddSourcer ( QTSPresentation inPresentation, QTSStream inStream, ComponentInstance inSourcer, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresExport ( QTSPresentation inPresentation, QTSStream inStream, QTSExportParams *inExportParams );
Undocumented
Undocumented
Undocumented
You can access Movie Toolbox error returns through GetMoviesError and GetMoviesStickyError, as well as in the function result. See Error Codes.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetActiveSegment ( QTSPresentation inPresentation, QTSStream inStream, TimeValue64 *outStartTime, TimeValue64 *outDuration );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hGets the clipping region for a streaming presentation.
OSErr QTSPresGetClip ( QTSPresentation inPresentation, QTSStream inStream, RgnHandle *outClip );
A pointer to a QTSPresentationRecord structure that defines a presentation.
A pointer to a QTSStreamRecord structure that defines a stream.
A pointer to a handle to a MacRegion structure that defines a clipping region.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the dimensions of a streaming presentation.
OSErr QTSPresGetDimensions ( QTSPresentation inPresentation, QTSStream inStream, Fixed *outWidth, Fixed *outHeight );
A pointer to a QTSPresentationRecord structure that defines a presentation.
A pointer to a QTSStreamRecord structure that defines a stream.
A pointer to the width in pixels.
A pointer to the height in pixels.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hDetermines whether or not a presentation is enabled.
OSErr QTSPresGetEnable ( QTSPresentation inPresentation, QTSStream inStream, Boolean *outEnableMode );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
A pointer to a Boolean that is TRUE if the presentation is enabled, FALSE otherwise.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the flags currently set for a presentation.
OSErr QTSPresGetFlags ( QTSPresentation inPresentation, SInt32 *outFlags );
A pointer to a QTSPresentationRecord structure that defines a presentation.
On entry, the address of a variable of type SInt32; on return, this variable is set to the current flags (see below) for the specified presentation. See these constants:
kQTSAutoModeFlag
kQTSDontShowStatusFlag
kQTSSendMediaFlag
kQTSReceiveMediaFlag
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the graphics mode and blend color in use for video display by a stream or presentation.
OSErr QTSPresGetGraphicsMode ( QTSPresentation inPresentation, QTSStream inStream, short *outMode, RGBColor *outOpColor );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want the graphics mode for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want the graphics mode for the presentation as a whole, pass the value kQTSAllStreams.
On entry, a pointer to a short integer; on return, this variable is set to the graphics mode of the specified presentation or stream. See Graphics Transfer Modes.
On entry, the address of an RGBColor structure; on return, this structure is filled in with information about the color used for blending and transparent operations. The stream handler passes this color to QuickDraw as appropriate when you draw in addPin, subPin, blend, or transparent mode.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the graphics port and graphics device in use by a stream or presentation.
OSErr QTSPresGetGWorld ( QTSPresentation inPresentation, QTSStream inStream, CGrafPtr *outGWorld, GDHandle *outGDHandle );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want the graphics mode for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want the graphics mode for the presentation as a whole, pass the value kQTSAllStreams.
On entry, the address of a variable of type CGrafPtr; on return, this variable is set to a pointer to a CGrafPort structure that defines the offscreen graphics world, color graphics port, or basic graphics port in use by the specified presentation or stream.
On entry, the address of a variable of type GDHandle; on return, this variable is set to the handle of a GDevice structure.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetIndSourcer ( QTSPresentation inPresentation, QTSStream inStream, UInt32 inIndex, ComponentInstance *outSourcer );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hGet a stream associated with a presentation, based on its index number.
QTSStream QTSPresGetIndStream ( QTSPresentation inPresentation, UInt32 inIndex );
A pointer to a QTSPresentationRecord structure.
The index number of the stream.
A pointer to a QTSStreamRecord structure.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets information about a presentation or stream.
OSErr QTSPresGetInfo ( QTSPresentation inPresentation, QTSStream inStream, OSType inSelector, void *ioParam );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want information for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want information for the presentation as a whole, pass the value kQTSAllStreams.
A constant (see below) that defines the information to be retrieved. See these constants:
kQTSGetURLLink
kQTSTargetBufferDurationInfo
kQTSTargetBufferDurationInfo
kQTSDurationInfo
kQTSSourceTrackIDInfo
kQTSSourceLayerInfo
kQTSSourceLanguageInfo
kQTSSourceTrackFlagsInfo
kQTSSourceDimensionsInfo
kQTSSourceVolumesInfo
kQTSSourceMatrixInfo
kQTSSourceClipRectInfo
kQTSSourceGraphicsModeInfo
kQTSSourceScaleInfo
kQTSSourceBoundingRectInfo
kQTSSourceUserDataInfo
kQTSSourceInputMapInfo
kQTSStatisticsInfo
kQTSMinStatusDimensionsInfo
kQTSNormalStatusDimensionsInfo
kQTSTotalDataRateInfo
kQTSTotalDataRateInInfo
kQTSTotalDataRateOutInfo
kQTSLostPercentInfo
kQTSMediaTypeInfo
kQTSNameInfo
kQTSCanHandleSendDataType
kQTSAnnotationsInfo
A pointer to the retrieved information in the format shown below.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the transformation matrix in use for the graphic display of a stream or presentation.
OSErr QTSPresGetMatrix ( QTSPresentation inPresentation, QTSStream inStream, MatrixRecord *outMatrix );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to get the matrix for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to get the matrix for the presentation as a whole, pass the value kQTSAllStreams.
On entry, the address of a MatrixRecord structure; on return, this structure is filled with the transformation matrix in use by the stream handler. Note that the matrix passed back is the one last set by QTSPresSetMatrix, regardless of any additional matrixes that might have been used.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the notification callback of a presentation.
OSErr QTSPresGetNotificationProc ( QTSPresentation inPresentation, QTSNotificationUPP *outNotificationProc, void **outRefCon );
A pointer to a QTSPresentationRecord structure.
A pointer to a Universal Procedure Pointer that accesses a QTSNotificationProc callback. The callback acts as a back channel from a presentation to its creator. The presentation sends notification of various events, such as a presentation, ending, or acknowledgment of a preroll request.
A handle to a constant to be passed to your QTSNotificationProc.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
UInt32 QTSPresGetNumSourcers ( QTSPresentation inPresentation, QTSStream inStream );
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
UInt32 QTSPresGetNumStreams ( QTSPresentation inPresentation );
A pointer to a QTSPresentationRecord structure.
Undocumented
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetPicture ( QTSPresentation inPresentation, QTSStream inStream, PicHandle *outPicture );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetPlayHints ( QTSPresentation inPresentation, QTSStream inStream, SInt32 *outFlags );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetPreferredRate ( QTSPresentation inPresentation, Fixed *outRate );
A pointer to a QTSPresentationRecord structure.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hDetermines whether presenting is enabled or disabled for a presentation or stream.
OSErr QTSPresGetPresenting ( QTSPresentation inPresentation, QTSStream inStream, Boolean *outPresentingMode );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to get the presenting state for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to get the presenting state for the presentation as a whole, pass the value kQTSAllStreams.
A pointer to a Boolean that is TRUE if presenting is enabled, FALSE if it is disabled.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetSettings ( QTSPresentation inPresentation, QTSStream inStream, QTAtomContainer *outSettings, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetSettingsAsText ( QTSPresentation inPresentation, QTSStream inStream, SInt32 inFlags, OSType inSettingsType, Handle *outText, QTSPanelFilterUPP inPanelFilterProc, void *inPanelFilterProcRefCon );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetTimeBase ( QTSPresentation inPresentation, TimeBase *outTimeBase );
A pointer to a QTSPresentationRecord structure.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresGetTimeScale ( QTSPresentation inPresentation, TimeScale *outTimeScale );
A pointer to a QTSPresentationRecord structure.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the sound volume levels of a stream or presentation.
OSErr QTSPresGetVolumes ( QTSPresentation inPresentation, QTSStream inStream, short *outLeftVolume, short *outRightVolume );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to get the volumes for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to get the volumes for the presentation as a whole, pass the value kQTSAllStreams.
On exit, the volume level of the left channel of the stream or presentation. The values returned may range from 0x0000 (silence) to 0x0100 (full volume).
On exit, the volume level of the right channel of the stream or presentation. The values returned may range from 0x0000 (silence) to 0x0100 (full volume).
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresHasCharacteristic ( QTSPresentation inPresentation, QTSStream inStream, OSType inCharacteristic, Boolean *outHasIt );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
void QTSPresIdle ( QTSPresentation inPresentation, QTSPresIdleParams *ioParams );
A pointer to a QTSPresentationRecord structure.
Undocumented
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresInvalidateRegion ( QTSPresentation inPresentation, RgnHandle inRegion );
A pointer to a QTSPresentationRecord structure.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresNewStream ( QTSPresentation inPresentation, OSType inDataType, const void *inData, UInt32 inDataLength, SInt32 inFlags, QTSStream *outStream );
A pointer to a QTSPresentationRecord structure.
Undocumented
Undocumented
Undocumented
Undocumented
A pointer to a QTSStreamRecord structure that defines a stream.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresPreroll ( QTSPresentation inPresentation, QTSStream inStream, UInt32 inTimeValue, Fixed inRate, SInt32 inFlags );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresPreroll64 ( QTSPresentation inPresentation, QTSStream inStream, const TimeValue64 *inPrerollTime, Fixed inRate, SInt32 inFlags );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPresPreview ( QTSPresentation inPresentation, QTSStream inStream, const TimeValue64 *inTimeValue, Fixed inRate, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresRemoveSourcer ( QTSPresentation inPresentation, QTSStream inStream, ComponentInstance inSourcer, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetActiveSegment ( QTSPresentation inPresentation, QTSStream inStream, const TimeValue64 *inStartTime, const TimeValue64 *inDuration );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetClip ( QTSPresentation inPresentation, QTSStream inStream, RgnHandle inClip );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetDimensions ( QTSPresentation inPresentation, QTSStream inStream, Fixed inWidth, Fixed inHeight );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetEnable ( QTSPresentation inPresentation, QTSStream inStream, Boolean inEnableMode );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetFlags ( QTSPresentation inPresentation, SInt32 inFlags, SInt32 inFlagsMask );
A pointer to a QTSPresentationRecord structure.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hSets the graphics transfer mode for a streaming presentation.
OSErr QTSPresSetGraphicsMode ( QTSPresentation inPresentation, QTSStream inStream, short inMode, const RGBColor *inOpColor );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
A short integer; see Graphics Transfer Modes.
A pointer to an RGBColor structure. This is the blend value for blends and the transparent color for transparent operations. The toolbox supplies this value to QuickDraw when you draw in addPin, subPin, blend, transparent, or graphicsModeStraightAlphaBlend mode.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetGWorld ( QTSPresentation inPresentation, QTSStream inStream, CGrafPtr inGWorld, GDHandle inGDHandle );
A pointer to a QTSPresentationRecord structure.
A pointer to a QTSStreamRecord structure that defines a stream.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hSets information for a presentation or stream.
OSErr QTSPresSetInfo ( QTSPresentation inPresentation, QTSStream inStream, OSType inSelector, void *ioParam );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to set information for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to set information for the presentation as a whole, pass the value kQTSAllStreams.
A constant (see below) that defines the type of information to be set. See these constants:
kQTSGetURLLink
kQTSTargetBufferDurationInfo
kQTSDurationInfo
kQTSSourceTrackIDInfo
kQTSSourceLayerInfo
kQTSSourceLanguageInfo
kQTSSourceTrackFlagsInfo
kQTSSourceDimensionsInfo
kQTSSourceVolumesInfo
kQTSSourceMatrixInfo
kQTSSourceClipRectInfo
kQTSSourceGraphicsModeInfo
kQTSSourceScaleInfo
kQTSSourceBoundingRectInfo
kQTSSourceUserDataInfo
kQTSSourceInputMapInfo
A pointer to the information to be set in the format shown below.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hSets the transformation matrix to be used by the graphic display of a stream or presentation.
OSErr QTSPresSetMatrix ( QTSPresentation inPresentation, QTSStream inStream, const MatrixRecord *inMatrix );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to set the matrix for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to set the matrix for the presentation as a whole, pass the value kQTSAllStreams.
A pointer to a MatrixRecord structure.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hSets the notification callback for a presentation.
OSErr QTSPresSetNotificationProc ( QTSPresentation inPresentation, QTSNotificationUPP inNotificationProc, void *inRefCon );
A pointer to a QTSPresentationRecord structure.
A Universal Procedure Pointer that accesses a QTSNotificationProc callback. The callback acts as a back channel from a presentation to its creator. The presentation sends notification of various events, such as a presentation, ending, or acknowledgment of a preroll request.
A pointer to data to be passed to your QTSNotificationProc.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetPlayHints ( QTSPresentation inPresentation, QTSStream inStream, SInt32 inFlags, SInt32 inFlagsMask );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to set the play hints for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to set the play hints for the presentation as a whole, pass the value kQTSAllStreams.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetPreferredRate ( QTSPresentation inPresentation, Fixed inRate, SInt32 inFlags );
A pointer to a QTSPresentationRecord structure.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hEnables or disables presentation of a stream to the user.
OSErr QTSPresSetPresenting ( QTSPresentation inPresentation, QTSStream inStream, Boolean inPresentingMode );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to enable or disable the presentation for a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to enable or disable the presentation as a whole, pass the value kQTSAllStreams.
Pass TRUE to enable the presentation, FALSE to disable it.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSetSettings ( QTSPresentation inPresentation, QTSStream inStream, QTAtomSpecPtr inSettings, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSettingsDialog ( QTSPresentation inPresentation, QTSStream inStream, SInt32 inFlags, QTSModalFilterUPP inFilterProc, void *inFilterProcRefCon );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hUndocumented
OSErr QTSPresSettingsDialogWithFilters ( QTSPresentation inPresentation, QTSStream inStream, SInt32 inFlags, QTSModalFilterUPP inFilterProc, void *inFilterProcRefCon, QTSPanelFilterUPP inPanelFilterProc, void *inPanelFilterProcRefCon );
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hSets the sound volume levels of a stream or presentation.
OSErr QTSPresSetVolumes ( QTSPresentation inPresentation, QTSStream inStream, short inLeftVolume, short inRightVolume );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to set the volume of a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to set the volume of the presentation as a whole, pass the value kQTSAllStreams.
The volume level to be set for the left channel of the stream or presentation. The values may range from 0x0000 (silence) to 0x0100 (full volume).
The volume level to be set for the right channel of the stream or presentation. The values may range from 0x0000 (silence) to 0x0100 (full volume).
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hRequests that a presentation skip to a given point, specified by a time value.
OSErr QTSPresSkipTo ( QTSPresentation inPresentation, UInt32 inTimeValue );
A pointer to a QTSPresentationRecord structure.
The time value to skip to, expressed in the time scale of the presentation.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hRequests that a streaming presentation skip to a given point, specified by a 64-bit time value.
OSErr QTSPresSkipTo64 ( QTSPresentation inPresentation, const TimeValue64 *inTimeValue );
A pointer to a QTSPresentationRecord structure.
A pointer to a signed 64-bit integer that contains the time value to skip to, expressed in the time scale of the presentation.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hStarts a streaming presentation or a stream.
OSErr QTSPresStart ( QTSPresentation inPresentation, QTSStream inStream, SInt32 inFlags );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to start a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to start the presentation as a whole, pass the value kQTSAllStreams.
Flags (see below) that govern the starting of the presentation or stream. See these constants:
See Error Codes. Returns noErr if there is no error.
If QTSPresPreroll has not been called, QuickTime must set up the streams and do everything that would have been done in preroll. If the presentation has already been prerolled, it should be ready to start immediately.
Introduced in QuickTime 4.
QuickTimeStreaming.hStops a streaming presentation or stream.
OSErr QTSPresStop ( QTSPresentation inPresentation, QTSStream inStream, SInt32 inFlags );
A pointer to a QTSPresentationRecord structure that defines a presentation. If you want to stop a specific stream, pass the value kQTSInvalidPresentation.
A pointer to a QTSStreamRecord structure that defines a stream. If you want to stop the presentation as a whole, pass the value kQTSAllStreams. All audio and video output will cease.
Flags that govern the stopping of the presentation or stream. No flags are currently defined.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hDisposes of a pointer to a streaming buffer that will be recirculated.
void QTSReleaseMemPtr ( QTSMemPtr inMemPtr, SInt32 inFlags );
A pointer to an opaque structure.
Undocumented
Introduced in QuickTime 4.
QuickTimeStreaming.hSets the name of a streaming network application.
OSErr QTSSetNetworkAppName ( const char *inAppName, SInt32 inFlags );
A pointer to a string containing the application's name.
A flag (see below) that determines whether the name is a full pathname. See these constants:
kQTSNetworkAppNameIsFullNameFlag
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.1.
QuickTimeStreaming.hUndocumented
ComponentResult QTSSourcerGetEnable ( QTSSourcer inSourcer, Boolean *outEnableMode, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult QTSSourcerGetInfo ( QTSSourcer inSourcer, OSType inSelector, void *ioParams );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult QTSSourcerGetTimeScale ( QTSSourcer inSourcer, TimeScale *outTimeScale );
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult QTSSourcerIdle ( QTSSourcer inSourcer, const TimeValue64 *inTime, SInt32 inFlags, SInt32 *outFlags );
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult QTSSourcerInitialize ( QTSSourcer inSourcer, const QTSSourcerInitParams *inInitParams );
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult QTSSourcerSetEnable ( QTSSourcer inSourcer, Boolean inEnableMode, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult QTSSourcerSetInfo ( QTSSourcer inSourcer, OSType inSelector, void *ioParams );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult QTSSourcerSetTimeScale ( QTSSourcer inSourcer, TimeScale inTimeScale );
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hGets the number of statistics that a statistic helper is reporting.
UInt32 QTSStatHelperGetNumStats ( QTSStatHelper inStatHelper );
A pointer to a QTSStatHelperRecord structure that defines the component instance of a statistics helper.
The number of statistics.
You can also find the number of statistics that a statistics helper is reporting by calling QTSStatHelperResetIter, then calling QTSStatHelperNext iteratively until it returns FALSE and counting the iterations.
Introduced in QuickTime 4.
QuickTimeStreaming.hTells a statistics helper to update its statistics.
OSErr QTSStatHelperGetStats ( QTSStatHelper inStatHelper );
A pointer to a QTSStatHelperRecord structure that defines the component instance of a statistics helper.
See Error Codes. Returns noErr if there is no error.
Statistics helpers update their statistics only when this function is called. You should call it at least once before calling QTSStatHelperNext, to ensure that the information returned is valid and current. The normal sequence is to call this function, then call QTSStatHelperResetIter, then make a series of calls to QTSStatHelperNext.
Introduced in QuickTime 4.
QuickTimeStreaming.hGets the next statistic from a statistic helper.
Boolean QTSStatHelperNext ( QTSStatHelper inStatHelper, QTSStatHelperNextParams *ioParams );
A pointer to a QTSStatHelperRecord structure that defines the component instance of a statistics helper.
On entry, a pointer to a QTSStatHelperNextParams structure; on return, this structure is filled in with information about the next statistic from the specified statistic helper.
FALSE if the last statistic has been returned, TRUE otherwise.
You need to call this function once to retrieve each statistic. The normal sequence is to call QTSStatHelperGetStats, then call QTSStatHelperResetIter, then make a series of calls to this function until it returns FALSE.
Introduced in QuickTime 4.
QuickTimeStreaming.hReset the iteration counter of a statistics helper, so the next call to QTSStatHelperNext returns the first statistic.
OSErr QTSStatHelperResetIter ( QTSStatHelper inStatHelper );
A pointer to a QTSStatHelperRecord structure that defines the component instance of a statistics helper.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hUndocumented
void QTSStreamBufferDataInfo ( QTSStreamBuffer *inStreamBuffer, unsigned char **outDataStart, UInt32 *outDataMaxLength );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QuickTimeStreaming.hObtains media-specific settings from the user through a dialog box.
ComponentResult RTPMPDoUserDialog ( RTPMediaPacketizer rtpm, ModalFilterUPP inFilterUPP, Boolean *canceled );
The component instance of the media packetizer.
A ModalFilterProc callback, which may be used in a call to the Mac OS ModalDialog function.
On return, a Boolean which is TRUE if the user pressed the cancel button in the dialog box. If this parameter is returned TRUE, the settings prior to calling this function should be retained.
See Error Codes. Returns noErr if there is no error.
This function invokes a media packetizer's modal dialog to obtain user settings. If the packetizer supports "more settings," you can put up a dialog allowing the user to enter media-specific settings. You can determine whether a packetizer has this characteristic by calling RTPMPHasCharacteristic). The settings can be obtained for storage by calling RTPMPGetSettingsIntoAtomContainerAtAtom, and can be restored or set directly from an application by calling RTPMPSetSettingsFromAtomContainerAtAtom.
This function may be called at any time.
Introduced in QuickTime 4.
QTStreamingComponents.hRenamed RTPMPReset.
ComponentResult RTPMPFlush ( RTPMediaPacketizer rtpm, SInt32 inFlags, SInt32 *outFlags );
Introduced in QuickTime 4.
QTStreamingComponents.hObtains information of various types from a media packetizer.
ComponentResult RTPMPGetInfo ( RTPMediaPacketizer rtpm, OSType inSelector, void *ioParams );
The component instance of the media packetizer you want information from.
The selector for the type information you want (see below). See these constants:
kRTPMPPayloadTypeInfo
kRTPMPRTPTimeScaleInfo
kRTPMPRequiredSampleDescriptionInfo
kRTPMPMinPayloadSize
kRTPMPMinPacketDuration
kRTPMPSuggestedRepeatPktCountInfo
A pointer to a data structure of the appropriate type to hold the information you are requesting. You need to allocate and dispose of this data structure.
See Error Codes. Returns qtsBadSelectorErr if inSelector requests a selector you do not support. Returns noErr if there is no error.
This function can be called at any time.
Introduced in QuickTime 4.
QTStreamingComponents.hReads the maximum packet duration currently set for this packetizer.
ComponentResult RTPMPGetMaxPacketDuration ( RTPMediaPacketizer rtpm, UInt32 *outMaxPacketDuration );
The component instance of the media packetizer.
On return, a pointer to a 32-bit integer containing the maximum packet duration, in milliseconds, that the packetizer is set to use.
See Error Codes. Returns noErr if there is no error.
The maximum allowable packet duration can change during a presentation, so you should obtain this value immediately before using it.
Introduced in QuickTime 4.
QTStreamingComponents.hReturns the maximum packet size, in bytes, that the packetizer is set to create.
ComponentResult RTPMPGetMaxPacketSize ( RTPMediaPacketizer rtpm, UInt32 *outMaxPacketSize );
The component instance of the media packetizer.
On return, a pointer to a 32-bit integer containing the maximum packet size, in bytes, that the packetizer is set to create.
See Error Codes. Returns noErr if there is no error.
The maximum allowable packet size can change during a presentation, so you should obtain this value immediately before using it.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the data type being handled by a media packetizer.
ComponentResult RTPMPGetMediaType ( RTPMediaPacketizer rtpm, OSType *outMediaType );
The component instance of the media packetizer.
On return, a pointer to the media's data type, such as VideoMediaType or SoundMediaType; see Data References.
See Error Codes. Returns noErr if there is no error.
The media's data type must be set prior to calling RTPMPSetSampleData. It cannot change afterward.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the component instance of the packet builder component being used by a media packetizer.
ComponentResult RTPMPGetPacketBuilder ( RTPMediaPacketizer rtpm, ComponentInstance *outPacketBuilder );
The component instance of the media packetizer whose packet builder you are interested in.
On return, a pointer to the component instance of the packet builder component in use by this media packetizer.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hUndocumented
ComponentResult RTPMPGetSettings ( RTPMediaPacketizer rtpm, QTAtomContainer *outSettings, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 6.
QTStreamingComponents.hReturn the media-specific settings of a media packetizer as text in a format presentable to the user.
ComponentResult RTPMPGetSettingsAsText ( RTPMediaPacketizer rtpm, Handle *text );
The component instance of a media packetizer.
Return a handle to a copy of your user settings in text format. The text is formatted as simple array of characters. There is no size byte or null termination. Allocate the handle to fit the text precisely.
See Error Codes. Returns noErr if there is no error.
This function expects you to return your user settings as text. It should be called only if the media packetizer supports packetizer-specific settings. To determine if your media packetizer supports this function, the application may call RTPMPHasCharacteristic.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the media-specific setting of a media packetizer.
ComponentResult RTPMPGetSettingsIntoAtomContainerAtAtom ( RTPMediaPacketizer rtpm, QTAtomContainer inOutContainer, QTAtom inParentAtom );
The component instance of the media packetizer.
The atom container that holds the settings atom, which the caller must allocate.
The atom that will hold the settings.
See Error Codes. Returns noErr if there is no error.
This function should be called only if the media packetizer supports packetizer-specific settings. To determine if a media packetizer supports this function, call RTPMPHasCharacteristic.
Introduced in QuickTime 4.
QTStreamingComponents.hReturns the time base passed to a media packetizer by RTPMPSetTimeBase.
ComponentResult RTPMPGetTimeBase ( RTPMediaPacketizer rtpm, TimeBase *outTimeBase );
The component instance of your media packetizer.
A pointer to the time base passed to you by RTPMPSetTimeBase.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the time scale in use by a media packetizer.
ComponentResult RTPMPGetTimeScale ( RTPMediaPacketizer rtpm, TimeScale *outTimeScale );
The component instance of media packetizer component.
On return, contains a pointer to the time scale in use by the packetizer. The time scale indicates the number of time units that pass in one second when the media is playing at a rate of 1.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hDetermines whether a media packetizer has a particular characteristic, such as whether it supports a user settings dialog.
ComponentResult RTPMPHasCharacteristic ( RTPMediaPacketizer rtpm, OSType inSelector, Boolean *outHasIt );
The component instance of the media packetizer.
A selector for the characteristic you want to know about. See these constants:
kRTPMPNoSampleDataRequiredCharacteristic
kRTPMPHasUserSettingsDialogCharacteristic
kRTPMPPrefersReliableTransportCharacteristic
kRTPMPRequiresOutOfBandDimensionsCharacteristic
On return, contains a Boolean value that is TRUE if the media packetizer has this characteristic, FALSE otherwise.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled periodically in your event loop to allocate time to each media packetizer.
ComponentResult RTPMPIdle ( RTPMediaPacketizer rtpm, SInt32 inFlags, SInt32 *outFlags );
The component instance of the media packetizer.
There are currently no defined flags.
On return, contains a pointer to a signed 32-bit integer that holds a flag (see below) from the packetizer. See these constants:
kRTPMPStillProcessingData
See Error Codes. Returns noErr if there is no error.
The packetizer will use this time to process the data in its buffer. If the data has not all been processed, this function returns the kRTPMPStillProcessingData flag. Data is placed in the buffer by RTPMPSetSampleData.
The packetizer may make calls to the packet builder in response to this call.
Introduced in QuickTime 4.
QTStreamingComponents.hInitializes a media packetizer component.
ComponentResult RTPMPInitialize ( RTPMediaPacketizer rtpm, SInt32 inFlags );
The component instance of the media packetizer.
A signed 32-bit integer containing the flags (see below) you wish to pass to the packetizer at start-up. See these constants:
kRTPMPRealtimeModeFlag
See Error Codes. Returns noErr if there is no error.
The calling component must call this function before sending any data to a media packetizer or making any RTPMPSet calls. The calling component then calls RTPMPSetSampleData and RTPMPIdle repeatedly. The calling component passes sample data (obtained, for example, from GetMediaSample), to the media packetizer by calling RTPMPSetSampleData. If RTPMPSetSampleData or RTPMPIdle return the flag kRTPMPStillProcessingData, then the calling component should call RTPMPIdle; if not, it is free to call RTPMPSetSampleData again.
Introduced in QuickTime 4.
QTStreamingComponents.hDetermines whether your packetizer can work with a given media type and sample description.
ComponentResult RTPMPPreflightMedia ( RTPMediaPacketizer rtpm, OSType inMediaType, SampleDescriptionHandle inSampleDescription );
The component instance of your media packetizer.
The media type, such as 'vide'; see Data References.
A handle to the SampleDescription structure.
Return noErr if you can packetize this type of data; return qtsUnsupportedFeatureErr if you cannot. See Error Codes.
This function must be implemented by your packetizer. It will be called before you are asked to packetize any data.
Introduced in QuickTime 4.
QTStreamingComponents.hAllows a media packetizer to stop packetizing its current input, set its state to idle, and flush its input buffer.
ComponentResult RTPMPReset ( RTPMediaPacketizer rtpm, SInt32 inFlags );
The component instance of the media packetizer.
A signed 32-bit integer containing any flags you are passing to the media packetizer. There are currently no defined flags.
See Error Codes. Returns noErr if there is no error.
You can use this function to stop the media packetizer and flush its input buffer when you wish to stop transmitting immediately, when you are skipping forward or backward in the stream, or if the network data connection is interrupted.
Introduced in QuickTime 4.
QTStreamingComponents.hSets any one of several parameters for a media packetizer.
ComponentResult RTPMPSetInfo ( RTPMediaPacketizer rtpm, OSType inSelector, const void *ioParams );
The component instance of the media packetizer.
A selector (see below) for the type of information you wish to set. See these constants:
kQTSSourceTrackIDInfo
kQTSSourceLayerInfo
kQTSSourceLanguageInfo
kQTSSourceTrackFlagsInfo
kQTSSourceDimensionsInfo
kQTSSourceVolumesInfo
kQTSSourceMatrixInfo
kQTSSourceClipRectInfo
kQTSSourceGraphicsModeInfo
kQTSSourceBoundingRectInfo
kQTSSourceScaleInfo
kQTSSourceUserDataInfo
kQTSSourceInputMapInfo
A pointer to a data structure of the appropriate type for the information you are passing.
Return qtsBadSelectorErr if you do not support the selector. Return noErr if there is no error. See Error Codes.
This function is used to pass track-level information about the media track to be packetized, such as its track ID, layer, and transformation matrix. Return qtsBadSelectorErr unless your packetizer is able to transmit this kind of data to your reassembler for use in the client movie.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the maximum packet duration that the media packetizer is to use.
ComponentResult RTPMPSetMaxPacketDuration ( RTPMediaPacketizer rtpm, UInt32 inMaxPacketDuration );
The component instance of the media packetizer.
An unsigned 32-bit integer containing the maximum packet duration in milliseconds. This value should not be smaller than the value returned from RTPMPGetInfo with the kRTPMPMinPacketDuration selector.
See Error Codes. Returns noErr if there is no error.
The maximum packet duration cannot be changed during a presentation, and this function cannot be called after calling RTPMPSetSampleData.
If RTPMPSetMaxPacketDuration is not called, a default value will be used.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the maximum packet size for packets created by a media packetizer.
ComponentResult RTPMPSetMaxPacketSize ( RTPMediaPacketizer rtpm, UInt32 inMaxPacketSize );
The component instance of the media packetizer.
An unsigned 32-bit integer specifying the maximum size, in bytes, of packets to be created. This value must not be smaller than the value returned from RTPMPGetInfo with the kRTPMPMinPayloadSize selector. The media packetizer will not create packets larger than this value. The limit applies only to the payload data.
See Error Codes. Returns noErr if there is no error.
The maximum packet size cannot change during a presentation. Streaming will be most efficient if this value is set to the largest packet size that can traverse the network without being split. RTPMPSetMaxPacketSize may not be called after calling RTPMPSetSampleData.
If RTPMPSetMaxPacketSize is not called, a default value will be used.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the type of media that a media packetizer will process.
ComponentResult RTPMPSetMediaType ( RTPMediaPacketizer rtpm, OSType inMediaType );
The component instance of the media packetizer.
The media type; see Data References.
See Error Codes. Returns noErr if there is no error.
The media type must be set prior to calling RTPMPSetSampleData and cannot change after such calls.
Introduced in QuickTime 4.
QTStreamingComponents.hSelects which packet builder a media packetizer will use.
ComponentResult RTPMPSetPacketBuilder ( RTPMediaPacketizer rtpm, ComponentInstance inPacketBuilder );
The component instance of the media packetizer.
The component instance of the packet builder component to use.
See Error Codes. Returns noErr if there is no error.
A media packetizer always sends its output to a packet builder. The specified packet builder may assemble actual RTP packets, or it may use information about the packet to build a hint track. You must set the packet builder using this call prior to any calls to RTPMPSetSampleData. You can also use this function to dynamically change the packet builder a media packetizer uses.
Introduced in QuickTime 4.
QTStreamingComponents.hProvides sample data directly to a media packetizer component.
ComponentResult RTPMPSetSampleData ( RTPMediaPacketizer rtpm, const RTPMPSampleDataParams *inSampleData, SInt32 *outFlags );
The component instance of the media packetizer.
A pointer to a RTPMPSampleDataParams structure containing the sample data you are passing. Calling this routine adds data cumulatively to any previous calls to this function. The data can contain any number of samples (1 or more), or a partial sample.
Flags (see below) that indicate processing status. This function will return kRTPMPWantsMoreDataFlag if it has completed processing of all pending data. Otherwise, you must make calls to RTPMPIdle until this function no longer returns kRTPMPStillProcessingData. See these constants:
kRTPMPStillProcessingData
See Error Codes. Returns noErr if there is no error.
This routine is called to pass media data directly to a media packetizer. The packetizer will not copy this data; it will call the release callback when it is finished with it. The media packetizer may or may not make calls to the packet builder in response to this call.
This call is normally followed by a series of calls to RTPMPIdle, which grants time to the media packetizer in order to process the data passed by this function.
Introduced in QuickTime 4.
QTStreamingComponents.hUndocumented
ComponentResult RTPMPSetSettings ( RTPMediaPacketizer rtpm, QTAtomSpecPtr inSettings, SInt32 inFlags );
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 6.
QTStreamingComponents.hSets the media-specific settings of a media packetizer, using an atom inside an atom container.
ComponentResult RTPMPSetSettingsFromAtomContainerAtAtom ( RTPMediaPacketizer rtpm, QTAtomContainer inContainer, QTAtom inParentAtom );
The component instance of the media packetizer.
The atom container that holds the settings atom.
The atom that holds the settings.
See Error Codes. Returns noErr if there is no error.
This function should be called only if the media packetizer supports packetizer-specific settings. To determine if a media packetizer supports this function, call RTPMPHasCharacteristic.
Introduced in QuickTime 4.
QTStreamingComponents.hTells your packetizer what time base is in use by the calling application.
ComponentResult RTPMPSetTimeBase ( RTPMediaPacketizer rtpm, TimeBase inTimeBase );
Component instance of your packetizer.
The time base in use for this stream. You can query this time base to find out the current time in the stream.
See Error Codes. Returns noErr if there is no error.
This function may be called during setup for a live transmission.
Your packetizer should not rely on receiving this call.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the time scale the media packetizer will use.
ComponentResult RTPMPSetTimeScale ( RTPMediaPacketizer rtpm, TimeScale inTimeScale );
The component instance of the media packetizer.
The time scale to use.
See Error Codes. Returns noErr if there is no error.
The time scale is the number of time units that pass in one second when the media is playing at a rate of 1. This time scale gives meaning to the times used when calling RTPMPSetSampleData.
The time scale must be set before calling RTPMPSetSampleData.
Introduced in QuickTime 4.
QTStreamingComponents.hPasses literal data directly to a packet builder component.
ComponentResult RTPPBAddPacketLiteralData ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, UInt8 *inData, UInt32 inDataLength, RTPPacketRepeatedDataRef *outDataRef );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacket.
A pointer to the data you are passing.
An unsigned 32-bit integer containing the length, in bytes, of the data you are passing.
On return, contains a pointer to a data reference. Use this reference if you wish to later tell the packet builder to use this same data again, without having to literally pass the data again. Pass in NIL if you do not need the packet builder to repeat the data. If you do not pass in NIL, you must dispose of the data explicitly by calling RTPPBReleaseRepeatedData.
See Error Codes. Returns noErr if there is no error.
This function will return a reference which can be used to specify the same data repeatedly without having to pass in the data again. This is done by calling RTPPBAddPacketRepeatedData with the reference which was returned by this function. For example, you can use this function to insert static header information into a packet prior to inserting media sample data. It will return a data reference you can use to insert the same static information into later packets.
To specify media data to be placed in a packet, a media packetizer should call RTPPBAddPacketSampleData.
Introduced in QuickTime 4.
QTStreamingComponents.hTells a packet builder component to insert previously-specified data into a packet.
ComponentResult RTPPBAddPacketRepeatedData ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, RTPPacketRepeatedDataRef inDataRef );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacket.
A reference to the data to repeat. This is normally a data reference returned by RTPPBAddPacketLiteralData or RTPPBAddPacketSampleData.
See Error Codes. Returns noErr if there is no error.
Use this function to cause a packet builder component to repeatedly insert the same data into packets without having to pass the data each time. This is typically done to repeat static header information into a series of packets, or to insert previously-sent sample data into a redundant packet. The data is first specified by a call to RTPPBAddPacketLiteralData or RTPPBAddPacketSampleData, which inserts the data the first time and returns a data reference. The data reference is then used with this function to send the data again.
When you are done sending the repeated data, release the data structure by calling RTPPBReleaseRepeatedData.
Introduced in QuickTime 4.
QTStreamingComponents.hCommands a packet builder component to insert media sample data into a packet.
ComponentResult RTPPBAddPacketSampleData ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, RTPMPSampleDataParams *inSampleDataParams, UInt32 inSampleOffset, UInt32 inSampleDataLength, RTPPacketRepeatedDataRef *outDataRef );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacket.
A pointer to a RTPMPSampleDataParams structure for the sample data you are inserting.
A 32-bit unsigned integer containing the offset into the sample media, in bytes.
A 32-bit unsigned integer specifying the number of bytes of media sample data to insert into the packet.
On return, contains a pointer to a data reference. Use this reference if you wish to later tell the packet builder to use this same sample data again, without having to literally pass the data again. Pass in NIL if you do not need the packet builder to repeat the data. If you do not pass in NIL , you must dispose of the data explicitly by calling RTPPBReleaseRepeatedData.
See Error Codes. Returns noErr if there is no error.
This function will return a reference which can be used to specify the same data repeatedly without having to pass in the data again. The media packetizer specifies the offset into the media and the length of the sample to insert. You can insert data repeatedly by calling RTPPBAddPacketRepeatedData with the reference which was returned by RTPPBAddPacketLiteralData.
When a reference is no longer needed, it should be disposed of by using the call RTPPBReleaseRepeatedData.
Introduced in QuickTime 4.
QTStreamingComponents.hProvides a 64-bit version of RTPPBAddPacketSampleData for large sample media.
ComponentResult RTPPBAddPacketSampleData64 ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, RTPMPSampleDataParams *inSampleDataParams, const UInt64 *inSampleOffset, UInt32 inSampleDataLength, RTPPacketRepeatedDataRef *outDataRef );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacket.
A pointer to a RTPMPSampleDataParams structure for the sample data you are inserting.
A 64-bit unsigned integer containing the offset into the sample media, in bytes.
A 32-bit unsigned integer specifying the number of bytes of media sample data to insert into the packet.
On return, contains a pointer to a data reference. Use this reference if you wish to later tell the packet builder to use this same sample data again, without having to literally pass the data again. Pass in NIL if you do not need the packet builder to repeat the data. If you do not pass in NIL , you must dispose of the data explicitly by calling RTPPBReleaseRepeatedData.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult RTPPBAddRepeatPacket ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, TimeValue inTransmissionOffset, UInt32 inSequenceNumber );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet into which the data will be placed. This is normally a reference returned by RTPPBBeginPacket.
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hTells a packet builder to create a new packet.
ComponentResult RTPPBBeginPacket ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, UInt32 inPacketMediaDataLength, RTPPacketRef *outPacket );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the new packet. This is normally a reference returned by RTPPBBeginPacketGroup.
An unsigned 32-bit integer specifying the maximum length of data that will be inserted into this packet. This includes the data for all subsequent RTPPBAddPacketLiteralData, RTPPBAddPacketSampleData, and RTPPBAddPacketRepeatedData calls until the packet is closed. The value of this parameter may be larger, but must not be smaller, than the amount of data inserted in the packet.
On return, contains a pointer to the packet. Use this reference to insert data into the packet.
See Error Codes. Returns noErr if there is no error.
The media packetizer uses this function to create each new packet, before inserting any literal, repeated, or sample data. A call to RTPPBBeginPacketGroup must be made before creating the first packet in a group. Data can be inserted into the packet using RTPPBAddPacketLiteralData, RTPPBAddPacketRepeatedData, or RTPPBAddPacketSampleData. When the packet is complete, call RTPPBEndPacket.
Introduced in QuickTime 4.
QTStreamingComponents.hTells a packet builder to create a new packet group.
ComponentResult RTPPBBeginPacketGroup ( RTPPacketBuilder rtpb, SInt32 inFlags, UInt32 inTimeStamp, RTPPacketGroupRef *outPacketGroup );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
A unsigned 32-bit integer containing the time stamp for this packet group.
On return, contains a pointer to a reference to the packet group. Use this data reference when creating a new packet or inserting data into a packet that belongs to this group.
See Error Codes. Returns noErr if there is no error.
A media packetizer creates a packet group using this function. The data reference returned by this function is then used to create a series of packets that belong to this group. The data reference is also required when inserting data into packets.
When the packet group is complete, call RTPPBEndPacketGroup.
Introduced in QuickTime 4.
QTStreamingComponents.hTells a packet builder that a packet is complete.
ComponentResult RTPPBEndPacket ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, UInt32 inTransmissionTimeOffset, UInt32 inDuration );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the new packet. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet containing the data. This is normally a reference returned by RTPPBBeginPacket.
The time offset at which the media sample data contained in this packet begins, in milliseconds. This offset is added to the RTP transmission time to determine when to send the packet.
The duration of this packet, specified in milliseconds.
See Error Codes. Returns noErr if there is no error.
Call this function once when each packet is complete.
Introduced in QuickTime 4.
QTStreamingComponents.hTells a packet builder component that a packet group is complete.
ComponentResult RTPPBEndPacketGroup ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
A data reference to the packet group being ended. This is normally a data reference returned by RTPPBBeginPacketGroup.
See Error Codes. Returns noErr if there is no error.
This function should be called when all the packets in a group are complete and the media packetizer is ready either to create a new packet group or to terminate the stream.
Introduced in QuickTime 4.
QTStreamingComponents.hGets the callback used to communicate with the caller of a media packetizer.
ComponentResult RTPPBGetCallback ( RTPPacketBuilder rtpb, RTPPBCallbackUPP *outCallback, void **outRefCon );
The component instance of the packet builder component.
A pointer to an RTPPBCallbackProc callback.
A handle to any data your callback needs.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hGets information about a streaming packet builder.
ComponentResult RTPPBGetInfo ( RTPPacketBuilder rtpb, OSType inSelector, void *ioParams );
The component instance of the packet builder component.
A constant (see below) that defines the type of information to retrieve. See these constants:
A pointer to the retrieved information.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hGets the relative sequence number for a streaming packet.
ComponentResult RTPPBGetPacketSequenceNumber ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, UInt32 *outSequenceNumber );
The component instance of the packet builder component.
Undocumented
A data reference to a packet group. This is normally a data reference returned by RTPPBBeginPacketGroup.
The RTP packet. This is normally a reference returned by RTPPBBeginPacket.
A pointer to the sequence number.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hUndocumented
ComponentResult RTPPBGetPacketTimeStampOffset ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, SInt32 *outTimeStampOffset );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the packet of interest. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet of interest. This is normally a reference returned by RTPPBBeginPacket.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hUndocumented
ComponentResult RTPPBGetSampleData ( RTPPacketBuilder rtpb, RTPMPSampleDataParams *inParams, const UInt64 *inStartOffset, UInt8 *outDataBuffer, UInt32 inBytesToRead, UInt32 *outBytesRead, SInt32 *outFlags );
The component instance of the packet builder component.
A pointer to a RTPMPSampleDataParams structure.
Undocumented
Undocumented
Undocumented
Undocumented
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hLets a packet builder deallocate data that will no longer be used.
ComponentResult RTPPBReleaseRepeatedData ( RTPPacketBuilder rtpb, RTPPacketRepeatedDataRef inDataRef );
The component instance of the packet builder component.
The data reference to the repeated data. This is normally a data reference returned by RTPPBAddPacketLiteralData or RTPPBAddPacketSampleData.
See Error Codes. Returns noErr if there is no error.
You must release the data if you have allowed RTPPBAddPacketLiteralData or RTPPBAddPacketSampleData to return a data reference, even if you have not called RTPPBAddPacketRepeatedData.You must either pass NIL to the data reference when adding literal or sample data, or you must release the data by calling this function.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the callback used to communicate with the caller of a media packetizer.
ComponentResult RTPPBSetCallback ( RTPPacketBuilder rtpb, RTPPBCallbackUPP inCallback, void *inRefCon );
The component instance of the packet builder component.
A Universal Procedure Pointer that references an RTPPBCallbackProc callback.
A pointer to any data your callback needs.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hSets information for a streaming packet builder.
ComponentResult RTPPBSetInfo ( RTPPacketBuilder rtpb, OSType inSelector, void *ioParams );
The component instance of the packet builder component.
A constant (see below) that defines the type of information to set. See these constants:
A pointer to the information.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the relative sequence number for a streaming packet.
ComponentResult RTPPBSetPacketSequenceNumber ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, UInt32 inSequenceNumber );
The component instance of the packet builder component.
Undocumented
A data reference to a packet group. This is normally a data reference returned by RTPPBBeginPacketGroup.
The RTP packet. This is normally a reference returned by RTPPBBeginPacket.
The sequence number to be set.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hUndocumented
ComponentResult RTPPBSetPacketTimeStampOffset ( RTPPacketBuilder rtpb, SInt32 inFlags, RTPPacketGroupRef inPacketGroup, RTPPacketRef inPacket, SInt32 inTimeStampOffset );
The component instance of the packet builder component.
A signed 32-bit integer containing any flags you are passing. There are currently no defined flags.
The packet group containing the packet of interest. This is normally a reference returned by RTPPBBeginPacketGroup.
The RTP packet of interest. This is normally a reference returned by RTPPBBeginPacket.
Undocumented
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 5.
QTStreamingComponents.hCalled by the base reassembler when it is processing a packet, allowing your packet reassembler to adjust the packet parameters before the packet is processed.
ComponentResult RTPRssmAdjustPacketParams ( RTPReassembler rtpr, RTPRssmPacket *inPacket, SInt32 inFlags );
The component instance of your packet reassembler
A pointer to the packet whose parameters can be adjusted.
A signed 32-bit integer containing any flags (see below) being passed to your packet reassembler.
See Error Codes. Returns noErr if there is no error.
Your packet reassembler can adjust the following parameters in each packet: payloadHeaderLength, dataLength, serverEditParams, and chunkFlags. If your packet reassembler does not implement this function, or takes no action, the default for these parameters will be: payloadHeaderLength =fixed header length that is set (default is 0); dataLength =packetData - transportHeaderLength - payloadHeaderLength; no serverEditParams; chunkFlags =0.
Introduced in QuickTime 4.
QTStreamingComponents.hForces the base reassembler to flush all packets currently queued in its lists.
ComponentResult RTPRssmClearCachedPackets ( RTPReassembler rtpr, SInt32 inFlags );
The component instance of the base reassembler.
Undocumented
See Error Codes. Returns noErr if there is no error.
This function retains the last sequence number and related information. It is useful only when the base reassembler is operating with the kRTPRssmQueueAndUseMarkerBitFlag flag set; see RTPRssmSetCapabilities.
Introduced in QuickTime 4.1. Replaces RTPRssmFlushPackets.
QTStreamingComponents.hLets your packet reassembler compute the size of a chunk, based on the packet list for the chunk, using your own algorithm.
ComponentResult RTPRssmComputeChunkSize ( RTPReassembler rtpr, RTPRssmPacket *inPacketListHead, SInt32 inFlags, UInt32 *outChunkDataSize );
The component instance of your packet reassembler.
A pointer to the list of packets that make up this chunk.
A signed 32-bit integer containing any flags being passed to your packet reassembler.
You should return a pointer to an unsigned 32-bit variable containing the calculated size for this chunk.
See Error Codes. Returns noErr if there is no error.
This function is called once for each packet list. Implement this function only if you need to override the base reassembler's default computation. If you do not implement this call, the base reassembler will compute the chunk size by summing the data lengths for all packets in the list.
Introduced in QuickTime 4.
QTStreamingComponents.hLets your packet reassembler write the chunk data, based on the list of packets for the chunk, using your own algorithm.
ComponentResult RTPRssmCopyDataToChunk ( RTPReassembler rtpr, RTPRssmPacket *inPacketListHead, UInt32 inMaxChunkDataSize, SHChunkRecord *inChunk, SInt32 inFlags );
The component instance of your packet reassembler.
A pointer to the list of packets that make up this chunk.
An unsigned 32-bit integer containing the maximum allowable chunks size.
A pointer to the chunk record. Write the chunk data to this record.
A 32-bit signed integer containing any flags being passed to your media packetizer.
See Error Codes. Returns noErr if there is no error.
This function is useful, for example, when an H.261 packet reassembler must adjust the byte at packet boundaries. Implement this function only if you need to override the base reassembler's default behavior. If you do not implement this function, the base reassembler will write the chunk data by taking dataLength bytes from each packet, starting at an offset of (packetData + transportHeaderLength + payloadHeaderLength).
Introduced in QuickTime 4.
QTStreamingComponents.hTells the base reassembler to dispose of a chunk that it has created or preserved for you.
ComponentResult RTPRssmDecrChunkRefCount ( RTPReassembler rtpr, SHChunkRecord *inChunk );
The component instance of the base reassembler component.
A pointer to the chunk record to dispose.
See Error Codes. Returns noErr if there is no error.
If you have overridden RTPRssmSendPacketList behavior, and are instructing the base reassembler to construct chunks manually, your packet assembler must explicitly dispose of the chunks by calling either this function or RTPRssmSendChunkAndDecrRefCount. This function is also used to release a chunk you have preserved using RTPRssmIncrChunkRefCount.
Introduced in QuickTime 4.
QTStreamingComponents.hFills in a packet structure manually.
ComponentResult RTPRssmFillPacketListParams ( RTPReassembler rtpr, RTPRssmPacket *inPacketListHead, SInt32 inNumWraparounds, SInt32 inFlags );
The component instance of the base reassembler.
A pointer to the RTPRssmPacket packet structure.
The high-order 32 bits of the timestamp for this packet. The low-order 32 bits are found in the RTP packet header.
A signed 32-bit integer containing any flags you are passing to the base reassembler.
See Error Codes. Returns noErr if there is no error.
Call this function only if your packet reassembler is overriding the RTPRssmSendPacketList behavior. The base reassembler will call back to your packet reassembler using RTPRssmAdjustPacketParams and RTPRssmComputeChunkSize.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the current flag settings for the base reassembler.
ComponentResult RTPRssmGetCapabilities ( RTPReassembler rtpr, SInt32 *outFlags );
The component instance of the base reassembler.
On return, contains a pointer to the reassembler's current flags (see below). See these constants:
kRTPRssmEveryPacketAChunkFlag
kRTPRssmQueueAndUseMarkerBitFlag
kRTPRssmTrackLostPacketsFlag
kRTPRssmNoReorderingRequiredFlag
See Error Codes. Returns noErr if there is no error.
Your packet reassembler can call this function at any time.
Introduced in QuickTime 4.
QTStreamingComponents.hCauses the base reassembler to create a chunk for you manually.
ComponentResult RTPRssmGetChunkAndIncrRefCount ( RTPReassembler rtpr, UInt32 inChunkDataSize, const TimeValue64 *inChunkPresentationTime, SHChunkRecord **outChunk );
The component instance of the base reassembler component.
An unsigned 32-bit integer containing the size of the chunk's data portion, in bytes.
A pointer to a 64-bit time value specifying the time at which this chunk should be presented, in units of the stream's time scale.
On return, contains a pointer to a newly-created SHChunkRecord structure.
See Error Codes. Returns noErr if there is no error.
This function is useful if you are overriding the RTPRssmSendPacketList behavior and constructing the chunk yourself. You must explicitly dispose of the chunk when you are done with it by calling either RTPRssmDecrChunkRefCount or RTPRssmSendChunkAndDecrRefCount.
Introduced in QuickTime 4.
QTStreamingComponents.hUndocumented
ComponentResult RTPRssmGetExtChunkAndIncrRefCount ( RTPReassembler rtpr, UInt32 inChunkDataSize, const TimeValue64 *inChunkPresentationTime, SInt32 inFlags, SHExtendedChunkRecord **outChunk );
Undocumented
Undocumented
Undocumented
Undocumented
A pointer to a pointer to a SHExtendedChunkRecord data structure.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 6. Can be used only with Mac OS X 10.1 and later.
QTStreamingComponents.hObtains information about your packet reassembler.
ComponentResult RTPRssmGetInfo ( RTPReassembler rtpr, OSType inSelector, void *ioParams );
The component instance of your packet reassembler.
A selector (see below) for the information desired. See these constants:
kQTSSourceTrackIDInfo
kQTSSourceLayerInfo
kQTSSourceLanguageInfo
kQTSSourceTrackFlagsInfo
kQTSSourceDimensionsInfo
kQTSSourceVolumesInfo
kQTSSourceMatrixInfo
kQTSSourceClipRectInfo
kQTSSourceGraphicsModeInfo
kQTSSourceScaleInfo
kQTSSourceBoundingRectInfo
kQTSSourceUserDataInfo
kQTSSourceInputMapInfo
A pointer to a data structure appropriate for the type of data requested (see below) . If your component understands the selector, write the requested information into the data structure this parameter points to.
See Error Codes. Returns noErr if there is no error.
Implement this function only for the selectors you understand. Delegate this function to the base reassembler for any other selectors. The base reassembler will correctly return an error if it doesn't understand the selector either.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the current value of the fixed payload header length from the base reassembler.
ComponentResult RTPRssmGetPayloadHeaderLength ( RTPReassembler rtpr, UInt32 *outPayloadHeaderLength );
The component instance of the base reassembler component.
On return, contains a pointer to an unsigned 32-bit integer containing the length of the payload header in bytes. If your packet reassembler does not implement RTPRssmAdjustPacketParams, or takes no action, the default payloadHeaderLength is the fixed header length that is set (default is 0).
See Error Codes. Returns noErr if there is no error.
Your packet reassembler can call this function at any time.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the component instance of the stream handler to which the base reassembler is sending your output.
ComponentResult RTPRssmGetStreamHandler ( RTPReassembler rtpr, ComponentInstance *outStreamHandler );
The component instance of the base reassembler.
On return, contains a pointer to the component instance of the stream handler your output is being sent to by the base reassembler.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hObtains the current time scale from the base reassembler.
ComponentResult RTPRssmGetTimeScale ( RTPReassembler rtpr, TimeScale *outSHTimeScale );
The component instance of the base reassembler.
On return, contains a pointer to the time scale in use by the stream handler that is processing your output.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hLets your packet reassembler extract the time scale from a received packet and return it to the base reassembler.
ComponentResult RTPRssmGetTimeScaleFromPacket ( RTPReassembler rtpr, QTSStreamBuffer *inStreamBuffer, TimeScale *outTimeScale );
The component instance of your packet reassembler.
A pointer to a received packet from which you may be able to extract a time scale.
Return a pointer to a valid time scale or return an error. If you return a time scale, the packet will be processed normally. If you return an error, the packet will be discarded.
See Error Codes. Returns noErr if there is no error.
If your packet reassembler has not specified a time scale as part of RTPRssmNewStreamHandler, or by calling RTPRssmSetTimeScale, the base reassembler calls this function when it receives packets, which allows your packet reassembler to extract the time scale from a received packet and return it to the base reassembler. Your packet reassembler must set a time scale for the stream handler before the base reassembler can process any incoming packets. If your packet reassembler doesn't know the time scale of its media in advance, because the time scale is contained in the packet header for example, the base reassembler will prompt you for a time scale whenever it receives a packet. If your packet reassembler always uses the same time scale, it should set the time scale when it opens a stream handler, and it does not need to implement this function. The base reassembler will discard received packets until it has been given a valid time scale.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled whenever a new packet arrives, giving your packet reassembler the opportunity to process the packet.
ComponentResult RTPRssmHandleNewPacket ( RTPReassembler rtpr, QTSStreamBuffer *inStreamBuffer, SInt32 inNumWraparounds );
The component instance of your packet reassembler.
A pointer to the newly-arrived packet.
The upper 32 bits of the 64-bit timestamp (the lower 32 bits are in the RTP packet timestamp).
See Error Codes. Returns noErr if there is no error.
You should implement this function only if you need to process the packet yourself, or if you need to extract information from the packets as they arrive (you need to monitor the payload header, for example). If you implement this function, you can process the packet as needed, then delegate the default processing to the base reassembler.
Introduced in QuickTime 4.
QTStreamingComponents.hDetermines what features your reassembler supports.
ComponentResult RTPRssmHasCharacteristic ( RTPReassembler rtpr, OSType inCharacteristic, Boolean *outHasIt );
The component instance of your packet reassembler.
A constant that defines the characteristic being tested.
A pointer to a Boolean value that is TRUE if your packet reassembler has the characteristic, FALSE otherwise.
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hTells the base reassembler to keep a copy of the most recent chunk after it has been sent.
ComponentResult RTPRssmIncrChunkRefCount ( RTPReassembler rtpr, SHChunkRecord *inChunk );
The component instance of the base reassembler.
A pointer to the chunk record you want to preserve.
See Error Codes. Returns noErr if there is no error.
This function is used to assist in loss recovery, for example. You must call RTPRssmDecrChunkRefCount to release the chunk when you no longer need it.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled when the base reassembler is ready to have your packet reassembler begin handling media packets.
ComponentResult RTPRssmInitialize ( RTPReassembler rtpr, RTPRssmInitParams *inInitParams );
The component instance of your packet reassembler
A pointer to an RTPRssmInitParams structure. Use the information contained in this structure to initialize your component.
See Error Codes. Returns noErr if there is no error.
This function is not called when the base reassembler opens your component for payload registration information.
Introduced in QuickTime 4.
QTStreamingComponents.hOpens a new stream handler and closes any currently-open stream handler.
ComponentResult RTPRssmNewStreamHandler ( RTPReassembler rtpr, OSType inSHType, SampleDescriptionHandle inSampleDescription, TimeScale inSHTimeScale, ComponentInstance *outHandler );
The component instance of the base reassembler.
The stream handler type.
A handle to a SampleDescription structure appropriate for this media type. Pass in NIL if you don't know the media type yet. This structure is passed by reference; the caller is responsible for maintaining it.
The time scale for the stream handler to use. Pass in 0 if the time scale is not yet known.
On return, contains a pointer to the component instance of the stream handler that has been opened.
See Error Codes. Returns noErr if there is no error.
You must pass in a valid SampleDescription structure and time scale before the stream handler can process packets. If you do not pass them as part of this function, do so using RTPRssmSetTimeScale and RTPRssmSetSampleDescription.
Introduced in QuickTime 4.
QTStreamingComponents.hReleases memory associated with a packet list that your packet reassembler created itself, or a list your reassembler took ownership of as a result of implementing RTPRssmSendPacketList.
ComponentResult RTPRssmReleasePacketList ( RTPReassembler rtpr, RTPRssmPacket *inPacketListHead );
The component instance of the base reassembler.
A pointer to the packet list to dispose of.
See Error Codes. Returns noErr if there is no error.
This is a housekeeping function that you do not need to perform for packet lists created and handled by the base reassembler, only for packet lists that you create or take ownership of yourself.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled to reset all packet reassembler and base reassembler variables for a new run of data.
ComponentResult RTPRssmReset ( RTPReassembler rtpr, SInt32 inFlags );
The component instance of your reassembler.
A signed 32-bit integer containing any flags being passed. No flags are currently defined.
See Error Codes. Returns noErr if there is no error.
This function differs from RTPRssmClearCachedPackets, which disposes of the packets but still retains the last sequence number and related information; this function resets all variables as if the reassembler were just opened.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled by the packet reassembler when it has finished constructing a chunk and wants the base reassembler to send it to the stream handler.
ComponentResult RTPRssmSendChunkAndDecrRefCount ( RTPReassembler rtpr, SHChunkRecord *inChunk, const SHServerEditParameters *inServerEdit );
The component instance of the base reassembler.
A pointer to an SHChunkRecord structure.
A pointer to an SHServerEditParameters structure containing the server edit parameters. Pass in NIL if there is no server edit.
See Error Codes. Returns noErr if there is no error.
Use this function to manually send a chunk if you have overridden the default behavior of RTPRssmSendPacketList. This function will decrement the reference count of the chunk.
Introduced in QuickTime 4.
QTStreamingComponents.hAllows the base reassembler to send loss notification to the stream handler.
ComponentResult RTPRssmSendLostChunk ( RTPReassembler rtpr, const TimeValue64 *inChunkPresentationTime );
The component instance of the base reassembler.
A pointer to a 64-bit time value indicating when the chunk would have been presented, in units of the stream's time scale.
See Error Codes. Returns noErr if there is no error.
Loss notification is normally performed automatically by the base reassembler. Use this function if you are handling losses or sending chunks manually.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled when the base reassembler is ready to send a sample or chunk based on a list of packets.
ComponentResult RTPRssmSendPacketList ( RTPReassembler rtpr, RTPRssmPacket *inPacketListHead, const TimeValue64 *inLastChunkPresentationTime, SInt32 inFlags );
The component instance of your packet reassembler.
A pointer to the packet list.
A pointer to a time value which specifies when to present this chunk, in units of the stream's time scale.
A signed 32-bit integer containing any flags being passed (see below). See these constants:
kRTPRssmLostSomePackets
See Error Codes. Returns noErr if there is no error.
Implement this call if your packet reassembler needs to modify the packet list, or if it overrides the default handling of packet loss. If you do not implement this call, the base reassembler will adjust the packet parameters on all packets in the list, compute the chunk size, and send the chunk. If packet loss has occurred, all the packets will be discarded and the stream handler will be informed that the chunk has been lost.
Introduced in QuickTime 4.
QTStreamingComponents.hNotifies the base reassembler to construct and send a chunk based on a part of the stream buffer.
ComponentResult RTPRssmSendStreamBufferRange ( RTPReassembler rtpr, RTPSendStreamBufferRangeParams *inParams );
The component instance of the base reassembler.
A pointer to an RTPSendStreamBufferRangeParams structure, which specifies the stream buffer, presentation time, start position in the buffer, length of the data in bytes, and any flags.
See Error Codes. Returns noErr if there is no error.
The contents of the stream buffer will be referenced, not copied. You are responsible for maintaining valid data in the stream buffer.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled when you have changed something in the stream handler and you want the notification propagated.
ComponentResult RTPRssmSendStreamHandlerChanged ( RTPReassembler rtpr );
The component instance of the base reassembler.
See Error Codes. Returns noErr if there is no error.
This function is useful, for example, if you have changed the dimensions of the video.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the capabilities of a streaming packet reassembler.
ComponentResult RTPRssmSetCapabilities ( RTPReassembler rtpr, SInt32 inFlags, SInt32 inFlagsMask );
The component instance of the base reassembler.
A signed 32-bit integer containing the logical OR of all the flags (see below) you are setting. See these constants:
kRTPRssmEveryPacketAChunkFlag
kRTPRssmQueueAndUseMarkerBitFlag
kRTPRssmTrackLostPacketsFlag
kRTPRssmNoReorderingRequiredFlag
Use this field to preserve the state of any flags you do not wish to alter. If a flag (see below) is set in this field, and is not set in the inFlags field, it will not be changed from its current setting.
See Error Codes. Returns noErr if there is no error.
Your packet reassembler can call this function at any time.
Introduced in QuickTime 4.
QTStreamingComponents.hSets various parameters of your packet reassembler; it is also called to set parameters of the base reassembler.
ComponentResult RTPRssmSetInfo ( RTPReassembler rtpr, OSType inSelector, void *ioParams );
The component instance of your packet reassembler.
A selector (see below) for the information being set. Ignore any selectors you do not understand. See these constants:
kQTSSourceTrackIDInfo
kQTSSourceLayerInfo
kQTSSourceLanguageInfo
kQTSSourceTrackFlagsInfo
kQTSSourceDimensionsInfo
kQTSSourceVolumesInfo
kQTSSourceMatrixInfo
kQTSSourceClipRectInfo
kQTSSourceGraphicsModeInfo
kQTSSourceScaleInfo
kQTSSourceBoundingRectInfo
kQTSSourceUserDataInfo
kQTSSourceInputMapInfo
A pointer to the information that should be set.
See Error Codes. Returns noErr if there is no error.
Delegate this function to the base reassembler for any selectors you don't understand. If the base reassembler doesn't understand them either, it will return an error to the caller.
Introduced in QuickTime 4.
QTStreamingComponents.hCalled by the packet reassembler to set a fixed header length for your payload.
ComponentResult RTPRssmSetPayloadHeaderLength ( RTPReassembler rtpr, UInt32 inPayloadHeaderLength );
The component instance of the base reassembler.
An unsigned 32-bit integer containing the fixed payload header length, in bytes. If your packet reassembler does not implement RTPRssmAdjustPacketParams, or takes no action, the default payloadHeaderLength is the fixed header length that is set (default is 0).
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QTStreamingComponents.hChanges the SampleDescription structure being used by the stream handler; all subsequent samples will be marked with this new structure.
ComponentResult RTPRssmSetSampleDescription ( RTPReassembler rtpr, SampleDescriptionHandle inSampleDescription );
The component instance of the base reassembler.
The handle of a SampleDescription structure to use. You are responsible for keeping the handle and the data structure valid during subsequent operations.
See Error Codes. Returns noErr if there is no error.
The SampleDescription structure is not passed on a per-packet basis, but a per-sample basis, so the SampleDescription structure should not be changed until a complete sample (sometimes called a "frame" or "chunk") has been reassembled.
Introduced in QuickTime 4.
QTStreamingComponents.hAssigns a stream handler to the output of the base reassembler.
ComponentResult RTPRssmSetStreamHandler ( RTPReassembler rtpr, ComponentInstance inStreamHandler );
The component instance of the base reassembler.
The component instance of the stream handler to use.
See Error Codes. Returns noErr if there is no error.
The stream handler must already be opened and initialized, and its time scale must already be set.
Use this function only if you have opened and initialized a stream handler yourself. The base reassembler will not close the stream handler it is already using.
Introduced in QuickTime 4.
QTStreamingComponents.hSets the time scale for the stream handler that will render your output.
ComponentResult RTPRssmSetTimeScale ( RTPReassembler rtpr, TimeScale inSHTimeScale );
The component instance of the base reassembler
The time scale for the stream handler to use
See Error Codes. Returns noErr if there is no error.
The time scale is the number of time units that pass in one second for the media whose sample data is carried in this stream. The stream handler's time scale must be set before it can deliver any data to the user.
This function is normally used by a packet reassembler when the time scale to use is not initially known. You don't need to call this function if you specified a time scale when the stream handler was opened.
Introduced in QuickTime 4.
QTStreamingComponents.hTerminates the QuickTime Streaming toolbox.
OSErr TerminateQTS ( void );
See Error Codes. Returns noErr if there is no error.
Introduced in QuickTime 4.
QuickTimeStreaming.hA back channel from a presentation to its creator, sending notification of various events such as a presentation, ending, or acknowledgment of a preroll request.
typedef ComponentResult (*QTSNotificationProcPtr) (ComponentResult inErr, OSType inNotificationType, void *inNotificationParams, void *inRefCon);
If you name your function MyQTSNotificationProc, you would declare it this way:
ComponentResult MyQTSNotificationProc ( ComponentResult inErr, OSType inNotificationType, void *inNotificationParams, void *inRefCon );
Undocumented
The kind of notification; see QuickTimeStreaming.h.
Undocumented
Undocumented
See Error Codes. Your callback should return noErr if there is no error.
QuickTimeStreaming.h, QTStreamingComponents.hRoutine called when a media packetizer is finished with its sample data.
typedef void (*RTPMPDataReleaseProcPtr) (UInt8 *inData, void *inRefCon);
If you name your function MyRTPMPDataReleaseProc, you would declare it this way:
void MyRTPMPDataReleaseProc ( UInt8 *inData, void *inRefCon );
A pointer to the data.
A pointer to information passed from a RTPMPSampleDataParams structure.
QuickTimeStreaming.h, QTStreamingComponents.hRoutine used to communicate with the caller of a media packetizer.
typedef void (*RTPPBCallbackProcPtr) (OSType inSelector, void *ioParams, void *inRefCon);
If you name your function MyRTPPBCallbackProc, you would declare it this way:
void MyRTPPBCallbackProc ( OSType inSelector, void *ioParams, void *inRefCon );
Undocumented
Undocumented
Undocumented
QuickTimeStreaming.h, QTStreamingComponents.hStores the functional requirements for a media packetizer.
struct MediaPacketizerRequirements {
OSType mediaType;
OSType dataFormat;
UInt32 capabilityFlags;
UInt8 canPackMatrixType;
UInt8 pad[3];
};
mediaTypeMedia type required; see Data References. 0 means all media types.
dataFormatData format required; see Media Identifiers. 0 means all formats.
capabilityFlagsConstants (see below) that indicate the packetizer's ability to handle non-standard track characteristics. See these constants:
kMediaPacketizerCanPackEditRate
kMediaPacketizerCanPackLayer
kMediaPacketizerCanPackVolume
kMediaPacketizerCanPackBalance
kMediaPacketizerCanPackGraphicsMode
kMediaPacketizerCanPackEmptyEdit
canPackMatrixTypeConstant (see below); the packetizer needs to pack any matrix type up to this level. Set to identityMatrixType for identity matrix (no translation) only. See these constants:
identityMatrixType
translateMatrixType
scaleMatrixType
scaleTranslateMatrixType
linearMatrixType
linearTranslateMatrixType
perspectiveMatrixType
padUnused.
QTSFindMediaPacketizer
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef MediaPacketizerRequirements * MediaPacketizerRequirementsPtr;
QTStreamingComponents.hSpecifies an atom and its container.
struct QTAtomSpec {
QTAtomContainer container;
QTAtom atom;
};
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef QTAtomSpec * QTAtomSpecPtr;
Movies.hUndocumented
struct QTSExportParams {
SInt32 version;
OSType exportType;
void *exportExtraData;
OSType destinationContainerType;
void *destinationContainerData;
void *destinationContainerExtras;
SInt32 flagsIn;
SInt32 flagsOut;
QTSModalFilterUPP filterProc;
void *filterProcRefCon;
Component exportComponent;
};
versionUndocumented
exportTypeUndocumented
exportExtraDataUndocumented
destinationContainerTypeUndocumented
destinationContainerDataUndocumented
destinationContainerExtrasUndocumented
flagsInUndocumented
flagsOutUndocumented
filterProcUndocumented
filterProcRefConUndocumented
exportComponentUndocumented
QTSPresExport
QuickTimeStreaming.h, QTStreamingComponents.hContains instant on information for QuickTime Streaming.
struct QTSInstantOnPref {
SInt32 flags;
SInt32 factor;
};
flagsConstants (see below) that enable instant on. See these constants:
kQTSInstantOnFlag_Enable
kQTSInstantOnFlag_Permitted
factorValues can range from 0 to 100; the default value is 50.
Introduced in QuickTime 6.
QTSPrefsGetInstantOnSettings
QTSPrefsSetInstantOnSettings
QuickTimeStreaming.h, QTStreamingComponents.hCombines the QTSVideoParams and QTSAudioParams structures.
struct QTSMediaParams {
QTSVideoParams v;
QTSAudioParams a;
};
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef struct OpaqueQTSMemPtr * QTSMemPtr;
QuickTimeStreaming.hSpecifies a presentation for QTSNewPresentation.
struct QTSNewPresentationParams {
OSType dataType;
const void * data;
UInt32 dataLength;
QTSEditListHandle editList;
SInt32 flags;
TimeScale timeScale;
QTSMediaParams * mediaParams;
QTSNotificationUPP notificationProc;
void * notificationRefCon;
};
dataTypeUndocumented
dataUndocumented
dataLengthUndocumented
editListA handle to a QTSEditList structure.
flagsUndocumented
timeScaleThe time scale; set to 0 for the default time scale.
mediaParamsUndocumented
notificationProcA pointer to a QTSNotificationProc callback.
notificationRefConA reference constant to be passed to the QTSNotificationProc callback.
QuickTimeStreaming.h, QTStreamingComponents.hProvides data for the QTSPrefsGetNoProxyURLs function.
struct QTSNoProxyPref {
UInt32 flags;
UInt32 seed;
char urlList[1];
};
flagsUndocumented
seedA seed value from the last time this setting was read from the system preferences.
urlListA null-terminated, comma-delimited list of URLs.
QTSPrefsGetNoProxyURLs
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef STACK_UPP_TYPE(QTSNotificationProcPtr) QTSNotificationUPP;
QuickTimeStreaming.hRepresents a type used by the QuickTime Streaming API.
typedef QTSPresentationRecord * QTSPresentation;
QuickTimeStreaming.hDefines a presentation.
struct QTSPresentationRecord {
long data[1];
};
QuickTimeStreaming.h, QTStreamingComponents.hProvides parameters for QTSPresIdle.
struct QTSPresIdleParams {
QTSStream stream;
TimeValue64 movieTimeToDisplay;
SInt32 flagsIn;
SInt32 flagsOut;
};
streamA pointer to a QTSStreamRecord structure.
movieTimeToDisplayUndocumented
flagsInUndocumented
flagsOutUndocumented
QTSPresIdle
QuickTimeStreaming.h, QTStreamingComponents.hUndocumented.
struct QTSPresParams {
UInt32 version;
QTSEditListHandle editList;
SInt32 flags;
TimeScale timeScale;
QTSMediaParams *mediaParams;
QTSNotificationUPP notificationProc;
void *notificationRefCon;
};
versionUndocumented
editListUndocumented
flagsUndocumented
timeScaleUndocumented
mediaParamsUndocumented
notificationProcUndocumented
notificationRefConUndocumented
QTSNewPresentationFromData
QTSNewPresentationFromDataRef
QTSNewPresentationFromFile
QuickTimeStreaming.h, QTStreamingComponents.hProvides data for the QTSPrefsFindProxyByType function.
struct QTSProxyPref {
UInt32 flags;
SInt32 portID;
UInt32 seed;
Str255 serverNameStr;
};
flagsUndocumented
portIDID of the port to use for this connection type.
seedA seed value from the last time this setting was read from the system preferences.
serverNameStrA proxy server URL.
QTSPrefsFindProxyByType
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef ComponentInstance QTSSourcer;
QTStreamingComponents.hHolds information for initializing a streaming sourcer.
struct QTSSourcerInitParams {
SInt32 version;
SInt32 flags;
OSType dataType;
void *data;
UInt32 dataLength;
};
versionUndocumented
flagsUndocumented
dataTypeUndocumented
dataUndocumented
dataLengthUndocumented
QTSNewSourcer
QTSSourcerInitialize
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef QTSStatHelperRecord * QTSStatHelper;
QuickTimeStreaming.hHolds information about the next streaming statistic obtained by QTSStatHelperNext.
struct QTSStatHelperNextParams {
SInt32 flags;
OSType returnedStatisticsType;
QTSStream returnedStream;
UInt32 maxStatNameLength;
char * returnedStatName;
UInt32 maxStatStringLength;
char * returnedStatString;
UInt32 maxStatUnitLength;
char * returnedStatUnit;
};
flagsUndocumented See these constants:
kQTSStatHelperReturnPascalStringsFlag
returnedStatisticsTypeUndocumented
returnedStreamOn return, a pointer to a QTSStreamRecord structure.
maxStatNameLengthUndocumented
returnedStatNameUndocumented; pass NIL if you don't want this information.
maxStatStringLengthUndocumented
returnedStatStringUndocumented; pass NIL if you don't want this information.
maxStatUnitLengthUndocumented
returnedStatUnitUndocumented; pass NIL if you don't want this information.
When you call QTSStatHelperNext, specifying a statistic helper and the address of this structure, QuickTime fills in this structure with information about the next statistic obtained by the statistic helper.
QTSStatHelperNext
QuickTimeStreaming.h, QTStreamingComponents.hDefines the component instance of a statistics helper.
struct QTSStatHelperRecord {
long data[1];
};
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef QTSStreamRecord * QTSStream;
QuickTimeStreaming.hDefines a stream buffer for QuickTime streaming.
struct QTSStreamBuffer {
struct QTSStreamBuffer * reserved1;
struct QTSStreamBuffer * reserved2;
struct QTSStreamBuffer * next;
unsigned char * rptr;
unsigned char * wptr;
long reserved3;
UInt32 metadata[4];
SInt32 flags;
};
reserved1Reserved; do not use.
reserved2Reserved; do not use.
nextA pointer to the next message block in a message.
rptrA pointer to the first byte in the data buffer that contains real data.
wptrA pointer to the byte after the last byte in the data buffer that contains real data.
reserved3Reserved; do not use.
metadataUsage defined by message sender.
flagsReserved; do not use.
QTSCopyMessage
QTSDupMessage
QTSFlattenMessage
QTSFreeMessage
QTSMessageLength
RTPRssmGetTimeScaleFromPacket
RTPRssmHandleNewPacket
QuickTimeStreaming.h, QTStreamingComponents.hContains a stream for QuickTime streaming.
struct QTSStreamRecord {
long data[1];
};
QuickTimeStreaming.h, QTStreamingComponents.hRecords streaming transport preferences.
struct QTSTransportPref {
OSType protocol;
SInt32 portID;
UInt32 flags;
UInt32 seed;
};
protocolConstant that identifies the streaming transport protocol; see Streaming Transport Atoms.
portIDID of the port to use for this connection type.
flagsConnection flags (see below). See these constants:
kConnectionActive
kConnectionUseSystemPref
seedA seed value from the last time this setting was read from the system preferences.
QTSPrefsFindConnectionByType
QTSPrefsGetActiveConnection
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef ComponentInstance RTPMediaPacketizer;
QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef STACK_UPP_TYPE(RTPMPDataReleaseProcPtr) RTPMPDataReleaseUPP;
QTStreamingComponents.hHolds media packetizer sample data, including any number of samples or a partial sample.
struct RTPMPSampleDataParams {
UInt32 version;
UInt32 timeStamp;
UInt32 duration;
UInt32 playOffset;
Fixed playRate;
SInt32 flags;
UInt32 sampleDescSeed;
Handle sampleDescription;
RTPMPSampleRef sampleRef;
UInt32 dataLength;
const UInt8 * data;
RTPMPDataReleaseUPP releaseProc;
void * refCon;
};
versionVersion of the data structure. Currently always 0.
timeStampRTP time stamp for the presentation of the sample data. This time stamp has already been adjusted by edits, edit rates, etc.
durationDuration (in RTP time scale) of the sample. For unknown duration, enter 0.
playOffsetOffset within the media sample itself. This is only used for media formats where a single media sample can span across multiple time units. QuickTime Music is an example of this, where a single sample spans the entire track. For most video and audio formats, this will be 0.
playRate1.0 (0x00010000) is normal. Higher numbers indicate faster play rates. Note that timeStamp is already adjusted by the rate. This field is generally of interest only to audio packetizers.
flagsFlag (see below) to indicate if the sample is a sync sample (key frame). See these constants:
kRTPMPSyncSampleFlag
sampleDescSeedIf the sample description changes, this number will change.
sampleDescriptionThe sample description for the given media sample.
sampleRefReserved; do not use.
dataLengthSize of the media data.
dataPointer to the media data.
releaseProcIf not NIL, you need to call your RTPMPDataReleaseProc when you are finished with the sample data.
refConInformation to pass to the RTPMPDataReleaseProc.
RTPPBAddPacketSampleData
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef ComponentInstance RTPPacketBuilder;
QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef struct OpaqueRTPPacketGroupRef * RTPPacketGroupRef;
QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef struct OpaqueRTPPacketRef * RTPPacketRef;
QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef struct OpaqueRTPPacketRepeatedDataRef * RTPPacketRepeatedDataRef;
QTStreamingComponents.hSpecifies the sort order for a list of packetizers.
struct RTPPayloadSortRequest {
long characteristicCount;
RTPPayloadCharacteristic characteristic[1];
};
characteristicCountThe number of structures in the characteristic field.
characteristicAn array of RTPPayloadCharacteristic structures.
QTSFindMediaPacketizer
QTSFindMediaPacketizerForPayloadID
QTSFindMediaPacketizerForPayloadName
QTSFindMediaPacketizerForTrack
QTSFindReassemblerForPayloadID
QTSFindReassemblerForPayloadName
QuickTimeStreaming.h, QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef RTPPayloadSortRequest * RTPPayloadSortRequestPtr;
QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef STACK_UPP_TYPE(RTPPBCallbackProcPtr) RTPPBCallbackUPP;
QTStreamingComponents.hRepresents a type used by the QuickTime Streaming API.
typedef ComponentInstance RTPReassembler;
QTStreamingComponents.hInitializes a packet reassembler component.
struct RTPRssmInitParams {
RTPSSRC ssrc;
UInt8 payloadType;
UInt8 pad[3];
TimeBase timeBase;
TimeScale timeScale;
};
ssrcUndocumented
payloadTypeUndocumented
padUnused.
timeBaseA reference to the reassembler's time base. You obtain a time base by calling GetMovieTimeBase or NewTimeBase.
timeScaleThe reassembler's time scale.
RTPRssmInitialize
QuickTimeStreaming.h, QTStreamingComponents.hA streaming reassembler packet list.
struct RTPRssmPacket {
struct RTPRssmPacket * next;
struct RTPRssmPacket * prev;
QTSStreamBuffer * streamBuffer;
Boolean paramsFilledIn;
UInt8 pad[1];
UInt16 sequenceNum;
UInt32 transportHeaderLength;
UInt32 payloadHeaderLength;
UInt32 dataLength;
SHServerEditParameters serverEditParams;
TimeValue64 timeStamp;
SInt32 chunkFlags;
SInt32 flags;
};
nextA pointer to the next RTPRssmPacket structure.
prevA pointer to the previous RTPRssmPacket structure.
streamBufferA pointer to a QTSStreamBuffer structure defining the stream buffer.
paramsFilledInUndocumented
padUndocumented
sequenceNumUndocumented
transportHeaderLengthUndocumented
payloadHeaderLengthUndocumented
dataLengthUndocumented
serverEditParamsUndocumented
timeStampUndocumented
chunkFlagsUndocumented
flagsUndocumented
RTPRssmAdjustPacketParams
RTPRssmComputeChunkSize
RTPRssmCopyDataToChunk
RTPRssmFillPacketListParams
RTPRssmReleasePacketList
RTPRssmSendPacketList
QuickTimeStreaming.h, QTStreamingComponents.hUndocumented
struct RTPSendStreamBufferRangeParams {
QTSStreamBuffer * streamBuffer;
TimeValue64 presentationTime;
UInt32 chunkStartPosition;
UInt32 numDataBytes;
SInt32 chunkFlags;
SInt32 flags;
const SHServerEditParameters * serverEditParams;
};
streamBufferUndocumented
presentationTimeUndocumented
chunkStartPositionUndocumented
numDataBytesUndocumented
chunkFlagsUndocumented
flagsUndocumented
serverEditParamsUndocumented
RTPRssmSendStreamBufferRange
QuickTimeStreaming.h, QTStreamingComponents.hDefines a chunk for a reassembler.
struct SHChunkRecord {
UInt32 version;
long reserved1;
SInt32 flags;
UInt32 dataSize;
const UInt8 * dataPtr;
long reserved2;
long reserved3;
TimeValue64 presentationTime;
long reserved4;
long reserved5;
const SHServerEditParameters * serverEditParameters;
long reserved6;
long reserved7;
};
versionUndocumented
reserved1Reserved; do not use.
flagsUndocumented
dataSizeThe size of the chunk data.
dataPtrA pointer to the chunk data.
reserved2Reserved; do not use.
reserved3Reserved; do not use.
presentationTimeUndocumented
reserved4Reserved; do not use.
reserved5Reserved; do not use.
serverEditParametersA pointer to an SHServerEditParameters structure containing the server edit parameters
reserved6Reserved; do not use.
reserved7Reserved; do not use.
RTPRssmCopyDataToChunk
RTPRssmDecrChunkRefCount
RTPRssmGetChunkAndIncrRefCount
RTPRssmIncrChunkRefCount
RTPRssmSendChunkAndDecrRefCount
QuickTimeStreaming.h, QTStreamingComponents.hExtends an SHChunkRecord data structure.
struct SHExtendedChunkRecord {
SHChunkRecord chunk;
SInt32 extendedFlags;
SInt32 extendedData[10];
};
chunkA SHChunkRecord data structure.
extendedFlagsConstants (see below) that indicate what data is being added. See these constants:
kSHExtendedChunkFlag_HasSampleCount
kSHExtendedChunkFlag_HasFrameLengths
extendedDataThe additional data.
Introduced in QuickTime 6.
RTPRssmGetExtChunkAndIncrRefCount
QuickTimeStreaming.h, QTStreamingComponents.hUndocumented
struct SHServerEditParameters {
UInt32 version;
Fixed editRate;
TimeValue64 dataStartTime_mediaAxis;
TimeValue64 dataEndTime_mediaAxis;
};
versionUndocumented
editRateUndocumented
dataStartTime_mediaAxisUndocumented
dataEndTime_mediaAxisUndocumented
Introduced in QuickTime 6.
RTPRssmGetExtChunkAndIncrRefCount
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to MediaPacketizerRequirements.
enum {
identityMatrixType = 0x00, /* result if matrix is identity */
translateMatrixType = 0x01, /* result if matrix translates */
scaleMatrixType = 0x02, /* result if matrix scales */
scaleTranslateMatrixType = 0x03, /* result if matrix scales and translates */
linearMatrixType = 0x04, /* result if matrix is general 2 x 2 */
linearTranslateMatrixType = 0x05, /* result if matrix is general 2 x 2 and translates */
perspectiveMatrixType = 0x06 /* result if matrix is general 3 x 3 */
};
enum {
kMediaPacketizerCanPackEditRate = 1 << 0,
kMediaPacketizerCanPackLayer = 1 << 1,
kMediaPacketizerCanPackVolume = 1 << 2,
kMediaPacketizerCanPackBalance = 1 << 3,
kMediaPacketizerCanPackGraphicsMode = 1 << 4,
kMediaPacketizerCanPackEmptyEdit = 1 << 5
};
identityMatrixTypeMatrix is identity; value is 0x00.
Available in Mac OS X v10.0 and later.
Declared in ImageCompression.h.
translateMatrixTypeMatrix translates; value is 0x01.
Available in Mac OS X v10.0 and later.
Declared in ImageCompression.h.
scaleMatrixTypeMatrix scales; value is 0x02.
Available in Mac OS X v10.0 and later.
Declared in ImageCompression.h.
scaleTranslateMatrixTypeMatrix translates and scales; value is 0x03.
Available in Mac OS X v10.0 and later.
Declared in ImageCompression.h.
linearMatrixTypeMatrix is general 2 x 2 type; value is 0x04.
Available in Mac OS X v10.0 and later.
Declared in ImageCompression.h.
linearTranslateMatrixTypeMatrix is general 2 x 2 type and translates; value is 0x05
Available in Mac OS X v10.0 and later.
Declared in ImageCompression.h.
perspectiveMatrixTypeMatrix is general 3 x 3 type; value is 0x06.
Available in Mac OS X v10.0 and later.
Declared in ImageCompression.h.
kMediaPacketizerCanPackEditRateThe packetizer can pack the edit rate value.
Available in Mac OS X v10.0 and later.
Declared in QTStreamingComponents.h.
kMediaPacketizerCanPackLayerThe packetizer can pack the layer number.
Available in Mac OS X v10.0 and later.
Declared in QTStreamingComponents.h.
kMediaPacketizerCanPackVolumeThe packetizer can pack the sound volume value.
Available in Mac OS X v10.0 and later.
Declared in QTStreamingComponents.h.
kMediaPacketizerCanPackBalanceThe packetizer can pack the sound balance value.
Available in Mac OS X v10.0 and later.
Declared in QTStreamingComponents.h.
kMediaPacketizerCanPackGraphicsModeThe packetizer can pack the graphics transfer mode value.
Available in Mac OS X v10.0 and later.
Declared in QTStreamingComponents.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSTransportPref.
enum {
kConnectionActive = (1L << 0),
kConnectionUseSystemPref = (1L << 1)
};
kConnectionActiveThe connection is active.
Available in Mac OS X v10.0 and later.
Declared in QuickTimeStreaming.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSStatisticsParams.
enum {
kQTSAllStatisticsType = 'all ',
kQTSShortStatisticsType = 'shrt',
kQTSSummaryStatisticsType = 'summ'
};
kQTSAllStatisticsTypeA full statistics helper for all statistics; constant value is 'all '.
Available in Mac OS X v10.0 and later.
Declared in QuickTimeStreaming.h.
kQTSShortStatisticsTypeA short statistics helper; constant value is 'shrt'.
Available in Mac OS X v10.0 and later.
Declared in QuickTimeStreaming.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSPresGetFlags.
enum {
kQTSAutoModeFlag = 0x00000001,
kQTSDontShowStatusFlag = 0x00000008,
kQTSSendMediaFlag = 0x00010000,
kQTSReceiveMediaFlag = 0x00020000
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSPrefsGetActiveConnection.
enum {
kQTSDirectConnectHTTPProtocol = 'http',
kQTSDirectConnectRTSPProtocol = 'rtsp'
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants grouped with kQTSDontGetDataStatisticsFlag.
enum {
kQTSGetNameStatisticsFlag = 0x00000001,
kQTSDontGetDataStatisticsFlag = 0x00000002,
kQTSUpdateAtomsStatisticsFlag = 0x00000004,
kQTSGetUnitsStatisticsFlag = 0x00000008,
kQTSUpdateAllIfNecessaryStatisticsFlag = 0x00010000
};
kQTSGetUnitsStatisticsFlagThe statistics helper is to get units statistics.
Available in Mac OS X v10.0 and later.
Declared in QuickTimeStreaming.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSPresSetInfo.
enum {
kQTSGetURLLink = 'gull' /* QTSGetURLLinkRecord* */
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSInstantOnPref.
enum {
kQTSInstantOnFlag_Enable = (1L << 0), /* instant on is enabled (read/write)*/
kQTSInstantOnFlag_Permitted = (1L << 1) /* instant on is possible (read only)*/
};
kQTSInstantOnFlag_EnableInstant on is enabled for read or write operations.
Available in Mac OS X v10.2 and later.
Declared in QuickTimeStreaming.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSMediaSetInfo.
enum {
kQTSMediaPresentationInfo = 'pres', /* QTSMediaPresentationParams* */
kQTSMediaNotificationInfo = 'noti', /* QTSMediaNotificationParams* */
kQTSMediaTotalDataRateInfo = 'dtrt', /* UInt32*,
bits/sec */
kQTSMediaLostPercentInfo = 'lspc', /* Fixed* */
kQTSMediaNumStreamsInfo = 'nstr', /* UInt32* */
kQTSMediaIndSampleDescriptionInfo = 'isdc' /* QTSMediaIndSampleDescriptionParams* */
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSNewPtr.
enum {
kQTSMemAllocAllocatedInTempMem = 0x00000001,
kQTSMemAllocAllocatedInSystemMem = 0x00000002
};
enum {
kQTSMemAllocClearMem = 0x00000001,
kQTSMemAllocDontUseTempMem = 0x00000002,
kQTSMemAllocTryTempMemFirst = 0x00000004,
kQTSMemAllocDontUseSystemMem = 0x00000008,
kQTSMemAllocTrySystemMemFirst = 0x00000010,
kQTSMemAllocHoldMemory = 0x00001000,
kQTSMemAllocIsInterruptTime = 0x01010000 /* currently not supported for alloc*/
};
kQTSMemAllocAllocatedInSystemMemThe block was allocated in system memory.
Available in Mac OS X v10.0 and later.
Declared in QuickTimeStreaming.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSSetNetworkAppName.
enum {
kQTSNetworkAppNameIsFullNameFlag = 0x00000001
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSStatHelperNextParams.
enum {
kQTSStatHelperReturnPascalStringsFlag = 0x00000001
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to QTSInsertStatisticUnits.
enum {
kQTSStatisticsNoUnitsType = 0,
kQTSStatisticsPercentUnitsType = 'pcnt',
kQTSStatisticsBitsPerSecUnitsType = 'bps ',
kQTSStatisticsFramesPerSecUnitsType = 'fps '
};
enum {
kQTSStatisticsStreamAtomType = 'strm',
kQTSStatisticsNameAtomType = 'name', /* chars only,
no length or terminator */
kQTSStatisticsDataFormatAtomType = 'frmt', /* OSType */
kQTSStatisticsDataAtomType = 'data',
kQTSStatisticsUnitsAtomType = 'unit', /* OSType */
kQTSStatisticsUnitsNameAtomType = 'unin' /* chars only,
no length or terminator */
};
kQTSStatisticsFramesPerSecUnitsTypeFrames-per-second unit type; value is 'fps '.
Available in Mac OS X v10.0 and later.
Declared in QuickTimeStreaming.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants grouped with kQTSStatisticsFixedDataFormat.
enum {
kQTSStatisticsSInt32DataFormat = 'si32',
kQTSStatisticsUInt32DataFormat = 'ui32',
kQTSStatisticsSInt16DataFormat = 'si16',
kQTSStatisticsUInt16DataFormat = 'ui16',
kQTSStatisticsFixedDataFormat = 'fixd',
kQTSStatisticsUnsignedFixedDataFormat = 'ufix',
kQTSStatisticsStringDataFormat = 'strg',
kQTSStatisticsOSTypeDataFormat = 'ostp',
kQTSStatisticsRectDataFormat = 'rect',
kQTSStatisticsPointDataFormat = 'pont'
};
kQTSStatisticsOSTypeDataFormatOSType (32-bit) format; value is 'ostp'.
Available in Mac OS X v10.0 and later.
Declared in QuickTimeStreaming.h.
QuickTimeStreaming.h, QTStreamingComponents.hIdentify transport atom types for QuickTime streaming.
enum {
kQTSTransAndProxyAtomType = 'strp', /* transport/proxy prefs root atom*/
kQTSConnectionPrefsVersion = 'vers', /* prefs format version*/
kQTSTransportPrefsAtomType = 'trns', /* tranport prefs root atom*/
kQTSConnectionAtomType = 'conn', /* connection prefs atom type,
one for each transport type*/
kQTSUDPTransportType = 'udp ', /* udp transport prefs*/
kQTSHTTPTransportType = 'http', /* http transport prefs*/
kQTSTCPTransportType = 'tcp ', /* tcp transport prefs */
kQTSProxyPrefsAtomType = 'prxy', /* proxy prefs root atom*/
kQTSHTTPProxyPrefsType = 'http', /* http proxy settings*/
kQTSRTSPProxyPrefsType = 'rtsp', /* rtsp proxy settings*/
kQTSSOCKSProxyPrefsType = 'sock', /* socks proxy settings*/
kQTSProxyUserInfoPrefsType = 'user', /* proxy username/password root atom*/
kQTSDontProxyPrefsAtomType = 'nopr', /* no-proxy prefs root atom*/
kQTSDontProxyDataType = 'data', /* no proxy settings*/
kQTSInstantOnPrefsAtomType = 'inon' /* instant on prefs*/
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants grouped with kRTPMPHasUserSettingsDialogCharacteristic.
enum {
kRTPMPNoSampleDataRequiredCharacteristic = 'nsdr',
kRTPMPHasUserSettingsDialogCharacteristic = 'sdlg',
kRTPMPPrefersReliableTransportCharacteristic = 'rely',
kRTPMPRequiresOutOfBandDimensionsCharacteristic = 'robd',
kRTPMPReadsPartialSamplesCharacteristic = 'rpsp'
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants grouped with kRTPInfo_FormatString.
enum {
kRTPMPPayloadTypeInfo = 'rtpp', /* RTPMPPayloadTypeParams* */
kRTPMPRTPTimeScaleInfo = 'rtpt', /* TimeScale* */
kRTPMPRequiredSampleDescriptionInfo = 'sdsc', /* SampleDescriptionHandle* */
kRTPMPMinPayloadSize = 'mins', /* UInt32* in bytes,
does not include rtp header; default is 0 */
kRTPMPMinPacketDuration = 'mind', /* UInt3* in milliseconds; default is no min required */
kRTPMPSuggestedRepeatPktCountInfo = 'srpc', /* UInt32* */
kRTPMPSuggestedRepeatPktSpacingInfo = 'srps', /* UInt32* in milliseconds */
kRTPMPMaxPartialSampleSizeInfo = 'mpss', /* UInt32* in bytes */
kRTPMPPreferredBufferDelayInfo = 'prbd', /* UInt32* in milliseconds */
kRTPMPPayloadNameInfo = 'name', /* StringPtr */
kRTPInfo_FormatString = 'fmtp' /* char **,
caller allocates ptr,
callee disposes */
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to RTPMPInitialize.
enum {
kRTPMPRealtimeModeFlag = 0x00000001
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to RTPMPIdle.
enum {
kRTPMPStillProcessingData = 0x00000001 /* not done with data you've got*/
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants grouped with kRTPMPRespectDurationFlag.
enum {
kRTPMPSyncSampleFlag = 0x00000001,
kRTPMPRespectDurationFlag = 0x00000002
};
kRTPMPSyncSampleFlagThe sample is a sync sample.
Available in Mac OS X v10.0 and later.
Declared in QTStreamingComponents.h.
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to RTPRssmSetCapabilities.
enum {
kRTPRssmEveryPacketAChunkFlag = 0x00000001,
kRTPRssmQueueAndUseMarkerBitFlag = 0x00000002,
kRTPRssmTrackLostPacketsFlag = 0x00010000,
kRTPRssmNoReorderingRequiredFlag = 0x00020000
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to RTPRssmSendPacketList.
enum {
kRTPRssmLostSomePackets = 0x00000001
};
QuickTimeStreaming.h, QTStreamingComponents.hConstants passed to SHExtendedChunkRecord.
enum {
kSHExtendedChunkFlag_HasSampleCount = 1 << 0,
kSHExtendedChunkFlag_HasFrameLengths = 1 << 1
};
kSHExtendedChunkFlag_HasSampleCountSample count data is added.
Available in Mac OS X v10.2 and later.
Declared in QTStreamingComponents.h.
QuickTimeStreaming.h, QTStreamingComponents.hLast updated: 2009-06-01