ホーム › Networking.BackgroundIntelligentTransferService › IBackgroundCopyFile6
IBackgroundCopyFile6
COMメソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
| offset | ULONGLONG | in | 次に優先してダウンロードする開始位置をバイト単位で指定するオフセット値。 |
vtbl 16 HRESULT RequestFileRanges(DWORD rangeCount, BG_FILE_RANGE* ranges)
| rangeCount | DWORD | in | ranges配列で要求するファイル範囲の要素数。 |
| ranges | BG_FILE_RANGE* | in | ダウンロードを要求するファイル範囲(開始位置と長さ)を記述するBG_FILE_RANGE配列。 |
vtbl 17 HRESULT GetFilledFileRanges(DWORD* rangeCount, BG_FILE_RANGE** ranges)
| rangeCount | DWORD* | out | ranges配列に格納された取得済み範囲の数を受け取る出力ポインタ。 |
| ranges | BG_FILE_RANGE** | out | 既にダウンロード済みのファイル範囲を記述するBG_FILE_RANGE配列を受け取る出力ポインタ。CoTaskMemFreeで解放する。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IBackgroundCopyFile6 "{CF6784F7-D677-49FD-9368-CB47AEE9D1AD}" #usecom global IBackgroundCopyFile6 IID_IBackgroundCopyFile6 "{}" #comfunc global IBackgroundCopyFile6_UpdateDownloadPosition 15 int64 #comfunc global IBackgroundCopyFile6_RequestFileRanges 16 int,var #comfunc global IBackgroundCopyFile6_GetFilledFileRanges 17 var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IBackgroundCopyFile6 "{CF6784F7-D677-49FD-9368-CB47AEE9D1AD}" #usecom global IBackgroundCopyFile6 IID_IBackgroundCopyFile6 "{}" #comfunc global IBackgroundCopyFile6_UpdateDownloadPosition 15 int64 #comfunc global IBackgroundCopyFile6_RequestFileRanges 16 int,sptr #comfunc global IBackgroundCopyFile6_GetFilledFileRanges 17 sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。