The CD-ROM XA Stream Handler is used to stream interleaved data to multiple streams and therefore multiple target devices. This is required to play multiple streams from a CD-ROM XA. For example, a CD-ROM XA file could have one channel of audio and one channel of video that need to be streamed at the same time. Because the audio and video are interleaved in the same file the CD-ROM XA Stream Handler can take these individual channels from the file and pass them to the Sync/Stream Manager as independent streams.
External Interface Description
The description for the CD-ROM XA Stream Handler external interface follows:
File Name
Device Control Blocks
This handler requires the standard DCB structure on the SHC_CREATE function. The szDevName must have the drive letter of the CD-ROM XA drive.
typedef struct _dcb /* dcb - Device Control Block */ {
ULONG ulDCBLen; /* Length of structure */
SZ szDevName[MAX_SPI_NAME]; /* Device driver name */
} DCB;
Associate Control Blocks
None.
Implicit (EVENT_IMPLICIT_TYPE) Events Supported
The following implicit (EVENT_IMPLICIT_TYPE) events for the CD-ROM XA Stream Handler are supported:
The error type will be set in the ulFlag field of the event implicit control block (EVCB). The three types of errors that will be reported are:
An error occurred during streaming but the stream handler, the Sync/Stream Manager or both the stream handler and the Sync/Stream Manager were able to continue streaming.
An error occurred that required the stream to be stopped. The application can restart the stream if appropriate.
A severe error occurred causing the stream handler to stop this stream. The stream cannot be restarted. The application must issue an SpiDestroyStream.
Explicit Events Supported
No explicit events are supported for the CD-ROM XA Stream Handler.
Stream Handler Commands Supported
The following stream handler commands (SHC) are supported. Refer to the OS/2 Multimedia Programming Reference for a description of these SHC commands and the error return codes.
Note: A stream requires a file to be opened and associated to the stream before a stream can be started.
Possible return codes:
Note: The primary stream is the stream that is created first for a interleaved file. The secondary streams must have the hstream handle of the primary stream in the hstreambuf parameter of the SpiCreateStream API. Only the CREATE for the primary stream needs to have the DCB filled in with the drive letter. Any DCB passed in on the secondary stream creates is ignored by this stream handler.
Possible return codes:
Note: Destroying the primary stream will suspend the streaming of the secondary streams because all the associated streams use the buffers owned by the primary stream.
Possible return codes:
Note: The streaming will only start when the SHC_START command is received for the primary stream, because it owns the I/O thread and the stream buffers.
Possible return codes:
Note: A stop for the primary stream will stop all the streams because it owns the I/O thread and the buffers. A stop for a secondary stream will only stop the data for that stream. If a secondary stream is stopped and restarted while the primary stream is still going, the secondary stream data will pick up at the interleaved point where the primary stream is.
Possible return codes:
Note: SEEK is only valid on the primary stream. A SEEK command on a secondary stream will return ERROR_DATA_ITEM_NOT_SEEKABLE.
The seek point is granular to the mmtimePerUnit specified in the SPCB.
Possible return codes:
Possible return codes:
Note: This stream handler allows only data types of DATATYPE_CDXA_AUDIO, DATATYPE_CDXA_VIDEO, or DATATYPE_CDXA_DATA to be installed.
Possible return codes:
Possible return codes:
Possible return codes:
Base Stream Protocol Control Block Data Types Supported
The CD-ROM XA Stream Handler has 7 base SPCBs.
旼컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴커쿞PCB Field 쿎DXA_LEVELB Values 쿎DXA_LEVELC Values � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀂pcbkey.ulDataType 쿏ATATYPE_CDXA_AUDIO 쿏ATATYPE_CDXA_AUDIO � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀂pcbkey.ulDataSubType 쿎DXA_LEVELB 쿎DXA_LEVELC � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lDataFlag 쿞PCBDATA_CUETIME 쿞PCBDATA_CUETIME � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lNumRec �17 �17 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBlockSize �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBufSize �39984 �39984 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lMinBuf �8 �8 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lMaxBuf �16 �16 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lSrcStart �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lTgtStart �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBufFlag 쿞PCBBUF_INTERLEAVED 쿞PCBBUF_INTERLEAVED � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lHandFlag 쿞PCBHAND_NOSYNC | � � � 쿞PCBHAND_PHYS_SEEK � � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBytesPerUnit �2304 �2304 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 쿺mtimePerUnit �160 �320 � 읕컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴켸
旼컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴커 쿞PCB Field 쿗EVELB_MONO Values 쿗EVELC_MONO Values � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀂pcbkey.ulDataType 쿏ATATYPE_CDXA_AUDIO 쿏ATATYPE_CDXA_AUDIO � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀂pcbkey.ulDataSubType 쿎DXA_LEVELB_MONO 쿎DXA_LEVELC_MONO � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lDataFlag 쿞PCBDATA_CUETIME 쿞PCBDATA_CUETIME � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lNumRec �17 �17 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBlockSize �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBufSize �39984 �39984 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lMinBuf �8 �8 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lMaxBuf �16 �16 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lSrcStart �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lTgtStart �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBufFlag 쿞PCBBUF_INTERLEAVED 쿞PCBBUF_INTERLEAVED � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lHandFlag 쿞PCBHAND_NOSYNC | � � � 쿞PCBHAND_PHYS_SEEK � � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBytesPerUnit �2304 �2304 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 쿺mtimePerUnit �320 �640 � 읕컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴켸
旼컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿞PCB Field 쿎DXA_AUDIO Values � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀂pcbkey.ulDataType 쿏ATATYPE_CDXA_AUDIO � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀂pcbkey.ulDataSubType 쿎DXA_AUDIO_HD � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lDataFlag 쿞PCBDATA_CUETIME � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lNumRec �17 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lBlockSize �1 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lBufSize �39984 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lMinBuf �8 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lMaxBuf �16 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lSrcStart �1 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lTgtStart �1 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lBufFlag 쿞PCBBUF_INTERLEAVED � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lHandFlag 쿞PCBHAND_NOSYNC | SPCBHAND_PHYS_SEEK � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 퀅lBytesPerUnit �0 � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿺mtimePerUnit �0 � 읕컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
旼컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴커 쿞PCB Field 쿎DXA_DATA Values 쿎DXA_VIDEO Values � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀂pcbkey.ulDataType 쿏ATATYPE_CDXA_DATA 쿏ATATYPE_CDXA_VIDEO � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀂pcbkey.ulDataSubType �0 �0 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lNumRec �17 �17 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBlockSize �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBufSize �39984 �39984 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lMinBuf �8 �8 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lMaxBuf �16 �16 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lSrcStart �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lTgtStart �1 �1 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBufFlag 쿞PCBBUF_INTERLEAVED 쿞PCBBUF_INTERLEAVED � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lHandFlag 쿞PCBHAND_NOSYNC | � � � 쿞PCBHAND_PHYS_SEEK � � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 퀅lBytesPerUnit �0 �0 � 쳐컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴캑 쿺mtimePerUnit �0 �0 � 읕컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴켸
Stream Handler Limits
Maximum number of streams associated to a primary stream is 15.
Maximum number of streams supported by the stream handler at one time is only limited by available memory.