GetTapePosition

論理または絶対ブロック単位でテープの現在のアドレスを取得する。

GetTapePosition hDevice, dwPositionType, lpdwPartition, lpdwOffsetLow, lpdwOffsetHigh

hDevice : [intptr] テープ位置を取得するデバイスのハンドル。このハンドルは CreateFile を使用して作成される。
dwPositionType : [int] 
lpdwPartition : [var] 現在のテープパーティションの番号を受け取る変数へのポインタ。パーティションは 1 から n まで論理的に番号付けされる。1 はテープ上の最初のパーティション、n は最後のパーティションである。デバイス固有のブロックアドレスが取得される場合、またはデバイスが 1 つのパーティションのみをサポートする場合、このパラメータは 0 を受け取る。
lpdwOffsetLow : [var] 現在のテープ位置の下位ビットを受け取る変数へのポインタ。
lpdwOffsetHigh : [var] 現在のテープ位置の上位ビットを受け取る変数へのポインタ。上位ビットが不要な場合、このパラメータは NULL でよい。

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

解説

論理または絶対ブロック単位でテープの現在のアドレスを取得する。

[戻り値]
関数が成功した場合、戻り値は NO_ERROR。関数が失敗した場合、以下のいずれかのエラーコードを返す。
(以下省略)

[備考]
論理ブロックアドレスはパーティションに対する相対位置である。各パーティションの最初の論理ブロックアドレスは 0
である。テープドライブとメディアの状態、機能、容量に関する情報を取得するには GetTapeParameters 関数を呼ぶ。

情報

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