IDirectPlayVoiceClient::SetClientConfig メソッド

IDirectPlayVoiceClient::SetClientConfig メソッド

クライアント構成を設定する。

構文

HRESULT SetClientConfig(      
    PDVCLIENTCONFIG pClientConfig
);

パラメータ

  • pClientConfig
    [in] 設定する構成の記述を保持する DVCLIENTCONFIG 構造体へのポインタ。

戻り値

成功した場合は DV_OK を返す。または、次のいずれかのエラー値を返す。

DVERR_INVALIDFLAGS このメソッドに渡されたフラグは無効である。
DVERR_INVALIDPARAM メソッドに渡された 1 つ以上のパラメータが無効である。
DVERR_INVALIDPOINTER 指定されたポインタが無効である。
DVERR_NOTCONNECTED Microsoft® DirectPlay® Voice オブジェクトが接続されていない。
DVERR_NOTINITIALIZED このメソッドを呼び出す前に、IDirectPlayVoiceClient::Initialize メソッドまたは IDirectPlayVoiceServer::Initialize メソッドを呼び出す必要がある。
DVERR_SESSIONLOST トランスポートはセッションへの接続を喪失した。

注意

DirectPlay Voice セッションで接続の確立に成功した後にのみ、このメソッドを呼び出すことができる。

このメソッドを呼び出すと、DVCLIENTCONFIG 構造体のすべてのパラメータが設定される。したがって、設定を変更しないようにするには、IDirectPlayVoiceClient::GetClientConfig を使って現在の構成を取得する必要がある。次に、パラメータを変更し、IDirectPlayVoiceClient::SetClientConfig を呼び出す。

セッションが半二重モードで実行されている場合、録音に関連する DVCLIENTCONFIG メソッドのメンバは無視される。