CheckHandleASyncLoad

ハンドルの非同期読み込みが完了しているかどうかを取得する

val = CheckHandleASyncLoad(Handle)

int Handle : チェックしたいハンドル

(プラグイン / モジュール : DxLibW)

解説

SetUseASyncLoadFlag 関数で非同期読み込みの設定にした状態で非同期読み込みに対応した関数を使用した場合は、
返ってくるハンドルは読み込みが完了するまで使うことができません。

この関数は、ハンドルの非同期読み込みが終わったかどうかをチェックするために使用します。

引数にハンドル( グラフィックハンドル、サウンドハンドル、フォントハンドル、ハンドルはなんでも )を渡すと、
非同期読み込みがまだ終わっていない場合は TRUE が、終わっている場合は FALSE が返ってきます。

尚、確かに正しいハンドルを渡しているはずなのに戻り値がエラーを示す -1 だ、という場合は、非同期読み込みが失敗したことを示します。
( 非同期読み込みが失敗するとハンドルは自動的に削除されます )

戻り値:
  TRUE:非同期読み込み中 FALSE:非同期読み込みは終了している -1:エラー

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib その他
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs