Vorbisfile documentation

libVorbisfile version 1.65 - 20020702

ov_callbacks

declared in "vorbis/codec.h"  "vorbis/vorbisfile.h"で定義されている

The ov_callbacks structure contains file manipulation function prototypes necessary for opening, closing, seeking, and location.
ov_callbacks構造体は、開く、閉じる、移動、位置所得を行うためのファイル操作関数のポインタを持っている。

The ov_callbacks structure does not need to be user-defined if you are working with stdio-based file manipulation; the ov_open() call provides default callbacks for stdio. ov_callbacks are defined and passed to ov_open_callbacks() when implementing non-stdio based stream manipulation (such as playback from a memory buffer).
stdioベースのファイル操作を行う場合、ov_callbacks構造体はユーザーが定義する必要はない; ov_open() が stdioのためのデフォルトのコールバックを提供するからだ。 stdioベースでないストリーム操作を実装する場合(メモリバッファから演奏する場合など)、 ov_callbacksを定義し、ov_open_callbacks() に渡す。

typedef struct {
  size_t (*read_func)  (void *ptr, size_t size, size_t nmemb, void *datasource);
  int    (*seek_func)  (void *datasource, ogg_int64_t offset, int whence);
  int    (*close_func) (void *datasource);
  long   (*tell_func)  (void *datasource);
} ov_callbacks;

Relevant Struct Members

read_func
Pointer to custom data reading function.
独自のデータ読み込み関数へのポインタ。
seek_func
Pointer to custom data seeking function. If the data source is not seekable (or the application wants the data source to be treated as unseekable at all times), the provided seek callback should always return -1 (failure).
独自の移動関数へのポインタ。もしデータソースが移動できない場合(もしくはアプリケーションが常に移動不可能なデータとして扱って欲しい場合)、準備する移動コールバック関数は常に-1(失敗)を返す必要がある。
close_func
Pointer to custom data source closure function.
独自のクローズ関数へのポインタ。
tell_func
Pointer to custom data location function.
独自の位置所得関数へのポインタ。

See the callbacks and non-stdio I/O document for more detailed information on required behavior of the various callback functions.
個々のコールバック関数に要求される振る舞いのより詳細な情報を参照するには、コールバックとstdioでないI/Oのドキュメント を見よ。




copyright © 2002 Xiph.org

Ogg Vorbis

Vorbisfile documentation

libVorbisfile version 1.65 - 20020702