次の方法で共有

DVSESSIONDESC 構造体

  • [アーティクル]

DVSESSIONDESC 構造体

Microsoft® DirectPlay® Voice サーバーの必要なセッション設定または現在のセッション設定を記述する。ボイス セッション ホストは、この構造体を使ってセッションを設定する。また、セッション ホストとクライアントはこの構造体を使って、現在のセッションに関する情報を取得する。

構文

typedef struct {
    DWORD dwSize;
    DWORD dwFlags;
    DWORD dwSessionType;
    GUID guidCT;
    DWORD dwBufferQuality;
    DWORD dwBufferAggressiveness;
} DVSESSIONDESC, *LPDVSESSIONDESC, *PDVSESSIONDESC;

メンバ

  • dwSize
    この構造体を使う前に、この構造体のサイズ (バイト単位) に設定する必要がある。

  • dwFlags
    次のフラグの組み合わせ。

    • DVSESSION_NOHOSTMIGRATION
      トランスポートの設定に関係なく、音声ホストは移行しない。このフラグを指定しない場合、トランスポートのサポートがあれば、音声ホストは移行する。
    • DVSESSION_SERVERCONTROLTARGET
      クライアントは音声のターゲットを制御できない。サーバー プレーヤのみが音声のターゲットを制御できる。サーバーがこのフラグを指定しない場合、クライアントのみが音声のターゲットを制御できる。このフラグは、マルチキャスト セッションおよびミキシング セッションでのみ指定できる。

  • dwSessionType
    実行する DirectPlay Voice セッションのタイプ。クライアント/サーバー セッションでは、DVSESSIONTYPE_PEER フラグは利用できない。他のすべてのフラグはすべてのセッション タイプに有効である。このメンバには次のいずれかの値を指定できる。

    • DVSESSIONTYPE_PEER
      音声メッセージをプレーヤ間で直接送信する。
    • DVSESSIONTYPE_MIXING
      ボイス セッションでミキシング サーバーを使う。この処理モードでは、すべての音声メッセージはサーバーに送信される。サーバーはミキシングし、単一のミキシング済みストリームを各クライアントに転送する。サーバーの帯域幅と CPU の使用量が増加する代わりに、クライアントの帯域幅と CPU の使用量は大きく減少する。
    • DVSESSIONTYPE_FOWARDING
      音声メッセージはセッション ホストを経由してルーティングされる。サーバーの帯域幅を使う代わりにクライアントの帯域幅は節約できる。セッション ホストが高速接続している場合にのみ、このオプションは役立つ。

  • guidCT
    セッションの圧縮タイプを指定する GUID。デフォルトの圧縮 CODEC を選択するには、このメンバを DPVCTGUID_DEFAULT に設定する。

  • dwBufferQuality
    バッファの品質設定。このメンバは、ミキシング セッション以外のセッション タイプでは使わない。ミキシング セッション以外のすべてのセッションでは、このメンバを DVBUFFERQUALITY_DEFAULT に設定する。

    DVBUFFERQUALITY_MIN から DVBUFFERQUALITY_MAX までの値が使用できる。また、このメンバは次の値にも設定できる。

    • DVBUFFERQUALITY_DEFAULT
      この値を指定すると、システムのデフォルト値が使われる。デフォルト値は、レジストリ エントリを使って調整できる。また、コントロール パネルの [サウンド] と [マルチメディア] からも設定できる。

  • dwBufferAggressiveness
    バッファの即応性の程度の設定。このメンバは、ミキシング セッション以外のセッション タイプでは使わない。ミキシング セッション以外のすべてのセッションでは、このメンバを DVBUFFERAGGRESSIVENESS_DEFAULT に設定する。

    DVBUFFERAGGRESSIVENESS _MIN から DVBUFFERAGGRESSIVENESS _MAX までの値が使える。また、このメンバは次の値にも設定できる。

    • DVBUFFERAGGRESSIVENESS_DEFAULT
      この値を指定すると、システムのデフォルト値が使われる。デフォルト値は、レジストリ エントリを使って調整できる。また、コントロール パネルからも設定できる。

注意

dwFlags、dwSessionType、guidCT の各メンバは、ホストがボイス セッションを開始するときのみ設定できる。ホストはいつでもバッファ設定を変更できる。

構造体の情報

ヘッダー dvoice8.h
最低限のオペレーティング システム Windows 98