linux-2.6.33/snd_card_create()
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
検索
|
最終更新
|
ヘルプ
|
ログイン
]
開始行:
*参照元 [#ac30b911]
#backlinks
*説明 [#sd4b909d]
-パス: [[linux-2.6.33/sound/core/init.c]]
-FIXME: これは何？
--説明
**引数 [#rbe22aa6]
-int idx
--
-const char *xid
--
-struct module *module
--
--[[linux-2.6.33/module]]
-int extra_size
--
-struct snd_card **card_ret
--
--[[linux-2.6.33/snd_card]]
**返り値 [#a29fd629]
-int
--
**参考 [#r8556b4b]
*実装 [#daa2102b]
/**
* snd_card_create - create and initialize a soundcard ...
* @idx: card index (address) [0 ... (SNDRV_CARDS-1)]
* @xid: card identification (ASCII string)
* @module: top level module for locking
* @extra_size: allocate this extra size after the main...
* @card_ret: the pointer to store the created card ins...
*
* Creates and initializes a soundcard structure.
*
* The function allocates snd_card instance via kzalloc...
* space for the driver to use freely. The allocated s...
* in the given card_ret pointer.
*
* Returns zero if successful or a negative error code.
*/
int snd_card_create(int idx, const char *xid,
struct module *module, int extra_size,
struct snd_card **card_ret)
{
struct snd_card *card;
int err, idx2;
if (snd_BUG_ON(!card_ret))
return -EINVAL;
*card_ret = NULL;
-
--[[linux-2.6.33/snd_BUG_ON()]]
if (extra_size < 0)
extra_size = 0;
card = kzalloc(sizeof(*card) + extra_size, GFP_KERNEL);
if (!card)
return -ENOMEM;
if (xid)
strlcpy(card->id, xid, sizeof(card->id));
-
--[[linux-2.6.33/kzalloc()]]
-
--[[linux-2.6.33/strlcpy()]]
err = 0;
mutex_lock(&snd_card_mutex);
-
--[[linux-2.6.33/mutex_lock()]]
-
--[[linux-2.6.33/snd_card_mutex(global)]]
if (idx < 0) {
for (idx2 = 0; idx2 < SNDRV_CARDS; idx2++)
/* idx == -1 == 0xffff means: take any free slot */
if (~snd_cards_lock & idx & 1<<idx2) {
if (module_slot_match(module, idx2)) {
idx = idx2;
break;
}
}
}
-
--[[linux-2.6.33/SNDRV_CARDS]]
-
--[[linux-2.6.33/module_slot_match()]]
-
--[[linux-2.6.33/snd_cards_lock(global)]]
if (idx < 0) {
for (idx2 = 0; idx2 < SNDRV_CARDS; idx2++)
/* idx == -1 == 0xffff means: take any free slot */
if (~snd_cards_lock & idx & 1<<idx2) {
if (!slots[idx2] || !*slots[idx2]) {
idx = idx2;
break;
}
}
}
if (idx < 0)
err = -ENODEV;
else if (idx < snd_ecards_limit) {
if (snd_cards_lock & (1 << idx))
err = -EBUSY; /* invalid */
} else if (idx >= SNDRV_CARDS)
err = -ENODEV;
-
--[[linux-2.6.33/snd_ecards_limit(global)]]
if (err < 0) {
mutex_unlock(&snd_card_mutex);
snd_printk(KERN_ERR "cannot find the slot for index %d...
idx, snd_ecards_limit - 1, err);
goto __error;
}
-
--[[linux-2.6.33/mutex_unlock()]]
-
--[[linux-2.6.33/snd_printk()]]
snd_cards_lock |= 1 << idx; /* lock it */
if (idx >= snd_ecards_limit)
snd_ecards_limit = idx + 1; /* increase the limit */
mutex_unlock(&snd_card_mutex);
card->number = idx;
card->module = module;
INIT_LIST_HEAD(&card->devices);
init_rwsem(&card->controls_rwsem);
rwlock_init(&card->ctl_files_rwlock);
INIT_LIST_HEAD(&card->controls);
INIT_LIST_HEAD(&card->ctl_files);
spin_lock_init(&card->files_lock);
INIT_LIST_HEAD(&card->files_list);
init_waitqueue_head(&card->shutdown_sleep);
-
--[[linux-2.6.33/INIT_LIST_HEAD()]]
-
--[[linux-2.6.33/init_rwsem()]]
-
--[[linux-2.6.33/rwlock_init()]]
-
--[[linux-2.6.33/spin_lock_init()]]
-
--[[linux-2.6.33/init_waitqueue_head()]]
#ifdef CONFIG_PM
mutex_init(&card->power_lock);
init_waitqueue_head(&card->power_sleep);
#endif
/* the control interface cannot be accessed from the us...
/* snd_cards_bitmask and snd_cards are set with snd_car...
err = snd_ctl_create(card);
if (err < 0) {
snd_printk(KERN_ERR "unable to register control minors...
goto __error;
}
-
--[[linux-2.6.33/snd_ctl_create()]]
err = snd_info_card_create(card);
if (err < 0) {
snd_printk(KERN_ERR "unable to create card info\n");
goto __error_ctl;
}
-
--[[linux-2.6.33/snd_info_card_create()]]
if (extra_size > 0)
card->private_data = (char *)card + sizeof(struct snd_...
*card_ret = card;
return 0;
__error_ctl:
snd_device_free_all(card, SNDRV_DEV_CMD_PRE);
-
--[[linux-2.6.33/snd_device_free_all()]]
-
--[[linux-2.6.33/SNDRV_DEV_CMD_PRE]]
__error:
kfree(card);
-
--[[linux-2.6.33/kfree()]]
return err;
}
EXPORT_SYMBOL(snd_card_create);
-ライセンスに関係なくシンボルを公開する。
--[[linux-2.6.33/EXPORT_SYMBOL()]]
*コメント [#i649ec9f]
終了行:
*参照元 [#ac30b911]
#backlinks
*説明 [#sd4b909d]
-パス: [[linux-2.6.33/sound/core/init.c]]
-FIXME: これは何？
--説明
**引数 [#rbe22aa6]
-int idx
--
-const char *xid
--
-struct module *module
--
--[[linux-2.6.33/module]]
-int extra_size
--
-struct snd_card **card_ret
--
--[[linux-2.6.33/snd_card]]
**返り値 [#a29fd629]
-int
--
**参考 [#r8556b4b]
*実装 [#daa2102b]
/**
* snd_card_create - create and initialize a soundcard ...
* @idx: card index (address) [0 ... (SNDRV_CARDS-1)]
* @xid: card identification (ASCII string)
* @module: top level module for locking
* @extra_size: allocate this extra size after the main...
* @card_ret: the pointer to store the created card ins...
*
* Creates and initializes a soundcard structure.
*
* The function allocates snd_card instance via kzalloc...
* space for the driver to use freely. The allocated s...
* in the given card_ret pointer.
*
* Returns zero if successful or a negative error code.
*/
int snd_card_create(int idx, const char *xid,
struct module *module, int extra_size,
struct snd_card **card_ret)
{
struct snd_card *card;
int err, idx2;
if (snd_BUG_ON(!card_ret))
return -EINVAL;
*card_ret = NULL;
-
--[[linux-2.6.33/snd_BUG_ON()]]
if (extra_size < 0)
extra_size = 0;
card = kzalloc(sizeof(*card) + extra_size, GFP_KERNEL);
if (!card)
return -ENOMEM;
if (xid)
strlcpy(card->id, xid, sizeof(card->id));
-
--[[linux-2.6.33/kzalloc()]]
-
--[[linux-2.6.33/strlcpy()]]
err = 0;
mutex_lock(&snd_card_mutex);
-
--[[linux-2.6.33/mutex_lock()]]
-
--[[linux-2.6.33/snd_card_mutex(global)]]
if (idx < 0) {
for (idx2 = 0; idx2 < SNDRV_CARDS; idx2++)
/* idx == -1 == 0xffff means: take any free slot */
if (~snd_cards_lock & idx & 1<<idx2) {
if (module_slot_match(module, idx2)) {
idx = idx2;
break;
}
}
}
-
--[[linux-2.6.33/SNDRV_CARDS]]
-
--[[linux-2.6.33/module_slot_match()]]
-
--[[linux-2.6.33/snd_cards_lock(global)]]
if (idx < 0) {
for (idx2 = 0; idx2 < SNDRV_CARDS; idx2++)
/* idx == -1 == 0xffff means: take any free slot */
if (~snd_cards_lock & idx & 1<<idx2) {
if (!slots[idx2] || !*slots[idx2]) {
idx = idx2;
break;
}
}
}
if (idx < 0)
err = -ENODEV;
else if (idx < snd_ecards_limit) {
if (snd_cards_lock & (1 << idx))
err = -EBUSY; /* invalid */
} else if (idx >= SNDRV_CARDS)
err = -ENODEV;
-
--[[linux-2.6.33/snd_ecards_limit(global)]]
if (err < 0) {
mutex_unlock(&snd_card_mutex);
snd_printk(KERN_ERR "cannot find the slot for index %d...
idx, snd_ecards_limit - 1, err);
goto __error;
}
-
--[[linux-2.6.33/mutex_unlock()]]
-
--[[linux-2.6.33/snd_printk()]]
snd_cards_lock |= 1 << idx; /* lock it */
if (idx >= snd_ecards_limit)
snd_ecards_limit = idx + 1; /* increase the limit */
mutex_unlock(&snd_card_mutex);
card->number = idx;
card->module = module;
INIT_LIST_HEAD(&card->devices);
init_rwsem(&card->controls_rwsem);
rwlock_init(&card->ctl_files_rwlock);
INIT_LIST_HEAD(&card->controls);
INIT_LIST_HEAD(&card->ctl_files);
spin_lock_init(&card->files_lock);
INIT_LIST_HEAD(&card->files_list);
init_waitqueue_head(&card->shutdown_sleep);
-
--[[linux-2.6.33/INIT_LIST_HEAD()]]
-
--[[linux-2.6.33/init_rwsem()]]
-
--[[linux-2.6.33/rwlock_init()]]
-
--[[linux-2.6.33/spin_lock_init()]]
-
--[[linux-2.6.33/init_waitqueue_head()]]
#ifdef CONFIG_PM
mutex_init(&card->power_lock);
init_waitqueue_head(&card->power_sleep);
#endif
/* the control interface cannot be accessed from the us...
/* snd_cards_bitmask and snd_cards are set with snd_car...
err = snd_ctl_create(card);
if (err < 0) {
snd_printk(KERN_ERR "unable to register control minors...
goto __error;
}
-
--[[linux-2.6.33/snd_ctl_create()]]
err = snd_info_card_create(card);
if (err < 0) {
snd_printk(KERN_ERR "unable to create card info\n");
goto __error_ctl;
}
-
--[[linux-2.6.33/snd_info_card_create()]]
if (extra_size > 0)
card->private_data = (char *)card + sizeof(struct snd_...
*card_ret = card;
return 0;
__error_ctl:
snd_device_free_all(card, SNDRV_DEV_CMD_PRE);
-
--[[linux-2.6.33/snd_device_free_all()]]
-
--[[linux-2.6.33/SNDRV_DEV_CMD_PRE]]
__error:
kfree(card);
-
--[[linux-2.6.33/kfree()]]
return err;
}
EXPORT_SYMBOL(snd_card_create);
-ライセンスに関係なくシンボルを公開する。
--[[linux-2.6.33/EXPORT_SYMBOL()]]
*コメント [#i649ec9f]
ページ名:
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
