DVSESSIONDESC
Microsoft® DirectPlay® Voice サーバーの必要なセッション設定または現在のセッション設定を記述する。音声セッション ホストは、この構造体を使用してセッションを設定する。また、セッション ホストとクライアントはこの構造体を使用して、現在のセッションに関する情報を取得する。dwFlags、dwSessionType、および guidCT の各メンバは、ホストが音声セッションを開始するときにのみ設定できる。ホストはいつでもバッファ設定を変更できる。
typedef struct {
DWORD dwSize;
DWORD dwFlags;
DWORD dwSessionType;
GUID guidCT;
DWORD dwBufferQuality;
DWORD dwBufferAggresiveness;
} DVSESSIONDESC, *LPDVSESSIONDESC, *PDVSESSIONDESC;
メンバ
- dwSize
- この構造体を使用する前に、この構造体のサイズ (バイト単位) に設定する必要がある。
- dwFlags
- 次のフラグの組み合わせ。
- DVSESSION_NOHOSTMIGRATION
- トランスポートの設定に関係なく、音声ホストは移行しない。このフラグを指定しない場合、トランスポートのサポートがあれば、ホストは移行する。
- DVSESSION_SERVERCONTROLTARGET
- クライアントは音声のターゲットを制御できない。サーバー プレーヤーのみが音声のターゲットを制御できる。サーバーがこのフラグを指定しない場合、クライアントのみが音声のターゲットを制御できる。このフラグは、マルチキャストおよびミキシング セッションでのみ指定できる。
- dwSessionType
- 実行する DirectPlay Voice セッションのタイプ。クライアント/サーバー セッションでは、DVSESSIONTYPE_PEER フラグは利用できない。ほかのすべてのフラグはすべてのセッション タイプに有効である。このメンバには次のいずれかの値を指定できる。
- DVSESSIONTYPE_PEER
- 音声メッセージをプレーヤー間で直接送信する。
- DVSESSIONTYPE_MIXING
- 音声セッションでミキシング サーバーを使用する。この処理モードでは、すべての音声メッセージはサーバーに送信される。サーバーはミキシングし、単一のミキシング済みストリームを各クライアントに転送する。サーバーの帯域幅と CPU の使用量が増加する代わりに、クライアントの帯域幅と CPU の使用量は大きく減少する。
- DVSESSIONTYPE_FOWARDING
- 音声メッセージはセッション ホストを経由してルーティングされる。サーバーの帯域幅を使用する代わりにクライアントの帯域幅は節約できる。セッション ホストが高速接続している場合にのみ、このオプションは役立つ。
- guidCT
- セッションの圧縮タイプを指定する GUID。
- dwBufferQuality
- バッファの品質設定。このメンバは、ミキシング セッション以外のセッション タイプでは使用しない。ミキシング セッション以外のすべてのセッションでは、このメンバを DVBUFFERQUALITY_DEFAULT に設定する。
DVBUFFERQUALITY_MIN から DVBUFFERQUALITY_MAX までの値が使用できる。また、このメンバは次の値にも設定できる。
- DVBUFFERQUALITY_DEFAULT
- この値を指定すると、システムのデフォルト値が使用される。デフォルト値は、レジストリ エントリを使用して調整できる。また、コントロール パネルの [サウンド] と [マルチメディア] からも設定できる。
- dwBufferAggresiveness
- バッファの即応性の程度の設定。このメンバは、ミキシング セッション以外のセッション タイプでは使用しない。ミキシング セッション以外のすべてのセッションでは、このメンバを DVBUFFERAGGRESIVENESS_DEFAULT に設定する。
DVBUFFERAGGRESIVENESS _MIN から DVBUFFERAGGRESIVENESS _MAX までの値が使用できる。また、このメンバは次の値にも設定できる。
- DVBUFFERAGGRESIVENESS_DEFAULT
- この値を指定すると、システムのデフォルト値が使用される。デフォルト値は、レジストリ エントリを使用して調整できる。また、コントロール パネルからも設定できる。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : Dvoice8.h で宣言。