linux-4.4.1/snd_pcm_preallocate_pages_for_all() の履歴(No.2)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• linux-4.4.1/snd_pcm_preallocate_pages_for_all() へ行く。
  • 1 (2017-06-13 (火) 10:30:07)
  • 2 (2017-06-13 (火) 10:37:11)

参照元†

説明†

• パス: linux-4.4.1/sound/core/pcm_memory.c

• FIXME: これは何？
  • 指定した PCM デバイスのすべての substream について、バッファを確保する。

引数†

• struct snd_pcm *pcm
  • PCM デバイス
  • linux-4.4.1/snd_pcm
• int type
  • バッファのタイプ
  • SNDRV_DMA_TYPE_CONTINUOUS
  • SNDRV_DMA_TYPE_DEV
  • など
• void *data
  • type によって何を渡せば良いか変わる
  • SNDRV_DMA_TYPE_CONTINUOUS なら GFP_XXXX
  • SNDRV_DMA_TYPE_DEV なら struct device *
• size_t size
  • バッファサイズ
• size_t max
  • 最大バッファサイズ、何に使われているのか良くわからない…

返り値†

• int
  • 0 なら成功、負のエラー値なら失敗。

参考†

実装†

/**
 * snd_pcm_lib_preallocate_pages_for_all - pre-allocation for continuous memory type (all substreams)
 * @pcm: the pcm instance
 * @type: DMA type (SNDRV_DMA_TYPE_*)
 * @data: DMA type dependent data
 * @size: the requested pre-allocation size in bytes
 * @max: the max. allowed pre-allocation size
 *
 * Do pre-allocation to all substreams of the given pcm for the
 * specified DMA type.
 *
 * Return: Zero if successful, or a negative error code on failure.
 */
int snd_pcm_lib_preallocate_pages_for_all(struct snd_pcm *pcm,
					  int type, void *data,
					  size_t size, size_t max)
{
	struct snd_pcm_substream *substream;
	int stream, err;

• linux-4.4.1/snd_pcm_substream

	for (stream = 0; stream < 2; stream++)
		for (substream = pcm->streams[stream].substream; substream; substream = substream->next)

• substream は playback と capture の 2つ
• pcm->streams は struct snd_pcm_str 型
  • substream はデバイスによって存在したり、存在しなかったりする
  • null じゃなければ存在していることになるようだ
  • linux-4.4.1/snd_pcm_str

			if ((err = snd_pcm_lib_preallocate_pages(substream, type, data, size, max)) < 0)
				return err;

• substream に対してバッファを確保する
  • linux-4.4.1/snd_pcm_lib_preallocate_pages()

	return 0;
}

EXPORT_SYMBOL(snd_pcm_lib_preallocate_pages_for_all);

• ライセンスに関係なくシンボルを公開する
  • linux-4.4.1/EXPORT_SYMBOL()

コメント†