論理または絶対ブロック単位でテープの現在のアドレスを取得する。
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 |
| URL | https://github.com/inovia/IronHSP |
| 備考 | Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。 |
| タイプ | 拡張命令 |
| グループ | Win32API |
| 対応環境 |
|
| hs ファイル | hsphelp\win32_kernel32_gen2.hs |