mmioSeek

mmioSeek 関数は mmioOpen 関数を使用してオープンしたファイルの現在のファイル位置を変更する。

mmioSeek hmmio, lOffset, iOrigin

hmmio : [intptr] シーク対象のファイルのファイルハンドル。
lOffset : [int] ファイル位置を変更するためのオフセット。
iOrigin : [int] lOffset で指定されたオフセットの解釈方法を示すフラグ。次の値が定義されている。

(プラグイン / モジュール : winmm.dll)

解説

mmioSeek 関数は mmioOpen 関数を使用してオープンしたファイルの現在のファイル位置を変更する。

[戻り値]
新しいファイル位置をファイル先頭からのバイト数で返す。エラーが発生した場合、戻り値は -1 となる。

[備考]
ファイル末尾を超える位置などファイル内の無効な場所へシークしても mmioSeek
がエラーを返さないことがあるが、そのファイルに対する以降の I/O 操作が失敗する可能性がある。ファイル末尾を特定するには、lOffset
を 0、iOrigin を SEEK_END に設定して mmioSeek を呼び出す。

情報

プラグイン / モジュールwinmm.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の winmm.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_winmm_gen2.hs