Creative SB0350 Hardware Programming Guide - Page 131

Creative SB0350 Manual

Page 131 highlights

File Format B-7 During digitized sound output, the CT-VOICE and CTVDSK drivers update the digitized sound status word with this value when the marker is encountered. You program can check for the desired marker value to perform synchronization with the digitized sound output process. Block Type 5 This block enables you to embed a null-terminated ASCII string in the .VOC file. The Block Header is organized as follows: BYTE BYTE BYTE bBlockID; nBlockLen[3]; szString[]; // == 5 // 3-byte block length // Null-terminated string Here is a discussion of various fields: bBlockID The Block Type identifier is 5. nBlockLen Length of the block (in bytes), excluding the bBlockID and nBlockLen fields. The value is the length of the null-terminated ASCII string (null inclusive). szString This is variable length field which specifies a null-terminated ASCII string. The length of this field is the string length (null inclusive). This field is for a program that requires ASCII information on the .VOC file such as name, type or remarks. You may choose to ignore this Block Type during the digitized sound block manipulation. Block Type 6 This block indicates the beginning of a repeat loop. The data block between this block and the next End Repeat Block (Block Type 7) will be repeated. The Block Header is organized as follows: BYTE BYTE WORD bBlockID; nBlockLen[3]; wRepeatTimes // == 6 // 3-byte block length

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141

File Format
B-7
During digitized sound output, the CT-VOICE and CTVDSK drivers
update the digitized sound status word with this value when the marker is
encountered.
You program can check for the desired marker value to
perform synchronization with the digitized sound output process.
Block Type 5
This block enables you to embed a null-terminated ASCII string in the .VOC file. The
Block Header is organized as follows:
BYTE
bBlockID;
// == 5
BYTE
nBlockLen[3];
// 3-byte block length
BYTE
szString[];
// Null-terminated string
Here is a discussion of various fields:
bBlockID
The Block Type identifier is 5.
nBlockLen
Length of the block (in bytes), excluding the
bBlockID
and
nBlockLen
fields.
The value is the length of the null-terminated ASCII string (null
inclusive).
szString
This is variable length field which specifies a null-terminated ASCII
string.
The length of this field is the string length (null inclusive).
This field is for a program that requires ASCII information on the .VOC file such as
name, type or remarks.
You may choose to ignore this Block Type during the digitized
sound block manipulation.
Block Type 6
This block indicates the beginning of a repeat loop.
The data block between this
block and the next End Repeat Block (Block Type 7) will be repeated.
The Block
Header is organized as follows:
BYTE
bBlockID;
// == 6
BYTE
nBlockLen[3];
// 3-byte block length
WORD
wRepeatTimes