Microsoft DirectX 8.0 (C++)

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 で宣言。