GetASyncLoadNum

非同期読み込み中の処理の数を取得する

GetASyncLoadNum

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

解説

SetUseASyncLoadFlag 関数で非同期読み込みの設定にした状態で非同期読み込みに対応した関数を使用して非同期読み込みを開始した場合は、
読み込みが終了するまで少し時間が掛かります。

各ハンドルが読み込みが完了したかどうかは CheckHandleASyncLoad で確認することができますが、
もっと大雑把に非同期読み込みが終わったかどうかを確認したいときはこの GetASyncLoadNum を使用します。

この関数は非同期読み込みが終わっていない処理の数を取得します、
単純に戻り値が０なら全ての非同期読み込みは完了していて、
１以上ならまだ非同期読み込みが終わっていないと判断することができます。

因みに、非同期読み込みが終わっていないハンドルの数ではなく、処理の数です。

例えば LoadDivGraph で 1000個のハンドルを生成する非同期読み込みが実行されていても、
GetASyncLoadNum では LoadDivGraph の処理一つ分ということで 1 が返ってきます。


尚、非同期読み込みがファイルが無かったりメモリが足りなかったりして失敗した場合も「非同期読み込み終了」として GetASyncLoadNum の戻り値は小さくなりますので、
エラーが発生したかどうかの確認は CheckHandleASyncLoad を使用する必要があります。

戻り値:
  実行しいる非同期読み込み処理の数

情報