forked from tkmsst/BonDriverProxyEx
-
Notifications
You must be signed in to change notification settings - Fork 3
/
ReadMe.txt
193 lines (160 loc) · 8.51 KB
/
ReadMe.txt
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
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
// これは何？
BonDriverProxyのサーバ側にBonDriver自動選択機能を加えたものです。
dll側はバイナリ互換なので、BonDriverProxyの物を使用できます。
BonDriverProxyとの設定方法の違いは、まずサーバ側のiniで、
---
[BONDRIVER]
00=PT-T;BonDriver_PT3-T0.dll;BonDriver_PT3-T1.dll
01=PT-S;BonDriver_PT3-S0.dll;BonDriver_PT3-S1.dll
---
の様な感じでチューナ空間とチャンネルの対応が同一のBonDriverを「;」区切りで並べます。
＃なので、グループ名やファイル名に「;」は使えません
BonDriverのグループは「00」「01」「02」...と言う感じで「00」からの連番で定義します。
(標準では)「00」から「63」までの最大64種類定義できます。
個々のグループのフォーマットは
「グループ名;ドライバ1;ドライバ2;ドライバ3...」
と言う感じになります。
グループ名は必須です。
なお、1グループに指定できるドライバの数は、(これも標準では)最大63個まで
＃あるいは、グループ名込みでの設定文字列の全体長がMAX_PATH(=260)*4文字まで
となっています。
クライアント側のiniでは、
---
[OPTION]
BONDRIVER=PT-T
---
の様な感じで、サーバ側iniのどのBonDriverグループを使用するか設定します。
機能の要件上、一つのグループに二つ以上のドライバが設定されている場合、
基本的には、クライアントからはそれらの内どれが使われるかは制御できなくなります。
一応、グループ名の最後に「:asc」及び「:desc」を付けると、サーバ側で設定されている
当該グループのドライバリストからの、空きドライバの検索順序を制御する事はできます。
指定無しの場合、あるいは明示的に「:asc」を指定した場合は、左から検索し、
「:desc」を指定した場合は、右から検索します。
例えば上記例の場合、
---
BONDRIVER=PT-T:desc
---
とした場合、BonDriver_PT3-T0.dllとBonDriver_PT3-T1.dllの両方が空きドライバであった場合、
BonDriver_PT3-T1.dllを使用するようになります。
ただし、あくまでも空きドライバの検索順序なので、空きが無い場合の使用ドライバをどれにするかを
制御できるものではありません。
＃またこの機能の為、グループ名として「:asc」もしくは「:desc」で終わる名称は使用できません
それら以外の設定は、元のBonDriverProxyと同じです。
＃iniのファイル名の命名規則も同じで、サーバモジュールの実行ファイルやクライアントモジュールのdllの
＃ファイル名の拡張子をiniに変更した物です。
＃例えば、サーバモジュールが「BonDriverProxyEx.exe」なら「BonDriverProxyEx.ini」となります。
グループ内のどのBonDriverを選択するかのアルゴリズムは、
・最初のリクエストではとりあえず可能であれば未使用の物を、それが無理ならなるべくチャンネルロックされていない
物を優先して選択
・チャンネル変更時、同一グループの中で、既に目的のチャンネルを開いているのがいたらそれを共有
その際、現在自分が持っているインスタンスは、他者と共有されていない限り開放する
・共有状態からのチャンネル変更時は、最初のリクエストと同じ
・チャンネルロックされているインスタンスを共有している時のチャンネル変更は、未使用かチャンネルロックされていない
インスタンスがある場合は使用インスタンスをそっちに切り替えて変更、無い場合は変更できない
こんな感じでしょうか？他にあるかな…
ぶっちゃけ自分でも書いてて訳がわからなくなってますが、実際テストパターンの網羅性にイマイチ自信が持ててないので、
何かしらバグがある可能性は高めです。
よっしゃテストしたるわ、という方がいたら追試していただけたらと思います。
// ライセンス
MITライセンスとします。
LICENSE.txt参照。
Jun/10/2014 unknown <[email protected]>
// 更新履歴
version 1.1.6.6 (Aug/07/2016)
・サーバ側にクライアントの接続状況を確認できるコマンドを追加した
version 1.1.6.5 (Jan/17/2016)
・接続中のクライアントがいる場合はスリープを抑止するようにした
version 1.1.6.4 (Nov/01/2015)
・サーバ側の待ち受けIPアドレスを複数指定可能(ただし最大8つまで)にした
version 1.1.6.3 (Sep/15/2015)
・チャンネル変更を行う際に、その時点でのインスタンスがそのリクエストを出したクライアントに対して
ロックされていなかった場合はそのままチャンネル変更していたのを、別インスタンスの最大優先度が
現在のインスタンスの最大優先度よりも低かった場合にはそちらを選択するようにした
version 1.1.6.2 (Sep/13/2015)
・サーバ側のTSパージ処理は実質不要なので簡素化した
＃TVTestはSetChannel()の前にPurgeTsStream()を呼ぶが、Ex版の場合はそのSetChannel()で別インスタンスを
＃使用するようになるかもしれないので、変更前インスタンスのTSデータをパージする必要は全く無い場合がある
＃この為、Ex版ではこの変更は特に都合が良い
version 1.1.6.1 (Sep/09/2015)
・排他ロックの先行優先に関して、2番手以降の排他権の獲得順序を厳密に要求順にした
version 1.1.6.0 (Sep/05/2015)
・チャンネルロック機能で先行優先の排他ロックを可能にした
＃ついでに設定方式を数値による優先度指定方式にした
version 1.1.5.5 (May/07/2015)
・サービス登録できるバージョンを追加した
・プロセスとスレッドの優先度を設定できるようにした
・UI有りバージョンにini再読み込み機能を追加した
・UI有りバージョンの情報窓を標準の閉じる操作で非表示にできるようにした
version 1.1.5.4 (May/06/2015)
・タスクトレイから終了と接続クライアント情報の表示/非表示が出来るだけのUIを追加した
version 1.1.5.3 (Feb/23/2015)
・BonDriverに対して実際にSetChannel()が行われた場合、それ以降に送信されるTSバッファとCNR値は、
確実にチャンネル変更後に取得した物になるようにした
＃もっとも、結局はその先のBonDriver次第ではある
・TsReader()で使用する各変数を構造体にまとめた
version 1.1.5.2 (Feb/18/2015)
・特定条件において、ロック権を持っていないクライアントインスタンスの保持チャンネルと
実際に選局されているチャンネルとの間にズレが生じる場合があったのを修正
version 1.1.5.1 (Feb/02/2015)
・COMを使用するBonDriverへの対策を追加
＃BonDriverによっては内部でCOMの初期化/終了処理を行う物があるが、使い方によっては
＃初期化は呼ばれても終了処理が呼ばれない場合がある為、COMの初期化/終了処理を
＃サーバプロセス側で行っておくようにした
version 1.1.5.0 (Jan/30/2015)
・サーバ側で一旦ロードしたBonDriverを、使用クライアントがいなくなった時にFreeLibrary()するのを
許可しない設定を追加
version 1.1.4.11 (Jan/29/2015)
・通るべきCloseTuner()を通らないコードパスがあったのを修正
version 1.1.4.10 (Jan/28/2015)
・BonDriverインスタンスを共有している複数のクライアントがほぼ同時にCloseTuner()した場合に、
解放済みメモリにアクセスしてしまう場合があったのを修正
version 1.1.4.9 (Jan/28/2015)
・Ex版のサーバに対してほぼ同時に複数のクライアントが接続してきた場合に、同一のBonDriverインスタンスに対して
複数のTS配信スレッドをつくってしまう場合があったのを修正
version 1.1.4.8 (Jan/26/2015)
・IBonDriver::Release()内部でのAccess Violation等の発生を無視する設定を追加
version 1.1.4.7 (Dec/23/2014)
・あるBonDriverグループに未使用BonDriverが無い状態で当該グループに更に使用要求が来た場合に、
グループのBonDriverインスタンスにチャンネルロックされていない物が複数ある場合は、それらの中で
ロード時刻あるいは使用要求時刻がもっとも古い物を、新規使用要求へのBonDriverインスタンスとして
割り当てるようにした
version 1.1.4.6 (Dec/19/2014)
・IPv6に対応した
・ホスト名として許可する長さを63文字以下から255文字以下にした
・サーバ側のlistenソケットのオプションをSO_EXCLUSIVEADDRUSEに変更した(winsockの仕様への対応)
・その他ロジックは変更無しでのソースコード整形
version 1.1.4.5 (Nov/21/2014)
・あるBonDriverインスタンスをCloseTuner()する際はTS読み出しスレッドを必ず停止させておくようにした
・あるBonDriverインスタンスがCloseTuner()時に、チューナのオープン状態フラグが正しく反映されない
パターンがあるのを修正
・レアケースだけどデッドロックするパターンへの対策を追加
・iniファイルが存在しなかった場合はエラーになるようにした
version 1.1.4.4 (Oct/17/2014)
・OpenTuner()の呼び出しが完了した後、指定時間ディレイさせる事ができる機能を追加
＃BonDriver_PT(正確には、PT1/2-SDKを使用するBonDriver)へのad-hoc対応
使用する場合は、サーバ側のiniの[OPTION]に追加で、
---
OPENTUNER_RETURN_DELAY=10
---
の様な形で指定(単位はms)
version 1.1.4.3 (Oct/11/2014)
・空きドライバの検索順序設定機能を追加
version 1.1.4.2 (Aug/28/2014)
・受信スレッドの冗長なチェックを削除
・delete対象として、NULLでない場合が大半の物に付いてはNULLチェック削除
・delete後、即スコープを抜けるなどでNULLクリアが不要な物はNULLクリア削除
・その他ロジックは変更無しでのソースコード整形
version 1.1.4.0 (Jul/04/2014)
・サーバ側のTSストリーム配信時のロック処理をロードしたBonDriverのインスタンス毎にグループ分けした
これにより、グローバルなインスタンスリストのロックや他のBonDriverインスタンスのTSストリーム配信処理の影響を
受けなくなるのと、個々のクライアントへのTSパケット作成時にロック及び比較処理が不要になる
・サーバ側のグローバルなインスタンスロック処理を厳密に行うのをデフォルトにした
＃詳細はBonDriverProxyの方のReadMe.txt参照
・チャンネル変更を行った際に、その対象BonDriverインスタンスを共有しているインスタンスが保持している
スペース/チャンネル情報を更新していなかったのを修正
version 1.1.2.0 (Jun/19/2014)
・SetChannel()内で、GetTsStream()でアプリに返したバッファを解放してしまうBonDriverを読み込んだ場合、
タイミングが悪いと解放後メモリにアクセスしてしまう可能性があったのに対応
・その他ロジックは(ほぼ)変更無しでのソースコード整形
version 1.1.1.0 (Jun/10/2014)
・初版リリース