# Shinobi Library

1998/10/4

# コンフィギュレーション関数

## 0. 概要

> 本関数は、BOOT ROMのGUIなどで使用するユーザ設定、例えば音声モード(ステレオ・モノラル)などのフラッシュメモリからの読み込み及び書き込みを行います。

## 1.データ仕様

### 1.1 マクロ定義

マクロ名 | 機能 | 実際の値
--- | --- | ---
SYD_CFG_STEREO | ステレオ設定 | (0x00)
SYD_CFG_MONO | モノラル設定 | (0x01)
SYD_CFG_OK | 正常終了 | (SYD_BT_CFG_OK)
SYD_CFG_NG | 異常終了 | (SYD_BT_CFG_ERR)

## 2.関数仕様

### 2.1関数一覧

関数 | 機能
--- | ---
syCfgInit＜新規＞ | コンフィギュレーション関数の初期化
syCfgExit＜新規＞ | コンフィギュレーション関数の終了
syCfgSetSoundMode＜新規＞ | 音声設定の更新
syCfgGetSoundMode＜新規＞ | 音声設定の取得

### 2.1関数仕様詳細

## syCfgInit

［関数 ］
  Sint32 syCfgInit( void* pBuf )
［入力］
  pBuf
    ライブラリで使用するバッファ(16K byte)のアドレスを指定します。
［出力］
  なし
［戻り値］
  エラーコード
  SYD_CFG_OK
    正常終了
  SYD_CFG_NG
    異常終了
［機能］
  関数の初期化を行います。
［備考］

## syCfgExit

［関数］
  Sint32 syCfgExit( Void )
［入力］
  なし
［出力］
  なし
［戻り値］
  エラーコード
  SYD_CFG_OK
    正常終了
  SYD_CFG_NG
    異常終了(現在未使用)
［機能］
  関数の終了処理を行います。
［備考］
  現仕様では、再入不可(Exitしたあと、再びInitすること)です。

## syCfgSetSoundMode

［関数］
  Sint32 syCfgSetSoundMode( Sint32 nMode ) ;
［入力］
  nMode
    SYD_CFG_STEREO
      ステレオ設定
    SYD_CFG_MONO
      モノラル設定
［出力］
  なし
［戻り値］
  エラーコード
  SYD_CFG_OK
    正常終了
  SYD_CFG_NG
    異常終了
［機能］
  音声設定(ステレオ/モノラル)を更新します。、
［備考］
  ・この関数では、フラッシュメモリに設定保存されます。
  音声設定情報のみ更新されます。
  実際の音声の変更は、別途行う必要があります。
  ・パラメータ不正時及び未初期化の場合は、異常終了とします。

## syCfgGetSoundMode

［関数］
  Sint32 syCfgSetSoundMode( Sint32* nMode ) ;
［入力］
  なし
［出力］
  nMode
    SYD_CFG_STEREO
      ステレオ設定
    SYD_CFG_MONO
      モノラル設定
［戻り値］
  エラーコード
  SYD_CFG_OK
    正常終了
  SYD_CFG_NG
    異常終了
［機能］
  音声設定(ステレオ/モノラル)を参照します。
［用例］

      Sint32 mode;
      syCfgGetSoundMode( &mode );
      if ( mode == SYD_CFG_STEREO ) {
        sdSndSetSpace( SDE_SPACE_STEREO );
      } else {
        sdSndSetSpace( SDE_SPACE_MONO );
      }

［備考］
  ・パラメータ不正時及び未初期化の場合は、異常終了とします。

オーバービューに戻る
TOPに戻る