ホーム › Storage.Imapi › IWriteEngine2EventArgs

IWriteEngine2EventArgs

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID27354136-7f64-5b0f-8f00-5d77afbe261e継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

現在の書き込み操作に関する情報を取得するために、このインターフェイスを使用します。このインターフェイスは、実装した DWriteEngine2Events::Update メソッドに渡されます。

メソッド 7

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_StartLba(INT* value)

現在の書き込み操作の開始論理ブロックアドレス (LBA) を取得します。

value

INT*

out

書き込み操作の開始論理ブロックアドレス。LBA には負の値も指定できます。

戻り値

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返されることもあります。操作が失敗した場合は次のエラーコードが返されることが一般的ですが、返される可能性のあるエラー値はこれらに限られません。

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

解説(Remarks)

これは IWriteEngine2::WriteSection メソッドに渡された値と同じです。

vtbl 8 HRESULT get_SectorCount(INT* value)

現在の書き込み操作でデバイスに書き込むセクター数を取得します。

value

INT*

out

現在の書き込み操作で書き込むセクター数。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

解説(Remarks)

これは IWriteEngine2::WriteSection メソッドに渡された値と同じです。

vtbl 9 HRESULT get_LastReadLba(INT* value)

書き込みイメージから直近に読み取られたセクターのアドレスを取得します。

value

INT*

out

入力データストリームから直近に読み取られたセクターの論理ブロックアドレス。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

vtbl 10 HRESULT get_LastWrittenLba(INT* value)

デバイスに直近に書き込まれたセクターのアドレスを取得します。

value

INT*

out

デバイスに直近に書き込まれたセクターの論理ブロックアドレス。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

vtbl 11 HRESULT get_TotalSystemBuffer(INT* value)

ディスクへの書き込みに使用される内部データバッファーのサイズを取得します。

value

INT*

out

ディスクへの書き込みに使用される内部データバッファーのサイズ (バイト単位)。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

vtbl 12 HRESULT get_UsedSystemBuffer(INT* value)

ディスクへの書き込みに使用される内部データバッファーのうち、使用済みのバイト数を取得します。

value

INT*

out

ディスクへの書き込みに使用される内部データバッファーの使用済み部分のサイズ (バイト単位)。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

解説(Remarks)

この値は、データがバッファーに読み込まれると増加し、データがディスクに書き込まれると減少します。

vtbl 13 HRESULT get_FreeSystemBuffer(INT* value)

ディスクへの書き込みに使用される内部データバッファーのうち、未使用のバイト数を取得します。

value

INT*

out

ディスクへの書き込みに使用される内部データバッファーの未使用部分のサイズ (バイト単位)。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

解説(Remarks)

このメソッドは、IWriteEngine2EventArgs::get_TotalSystemBuffer から IWriteEngine2EventArgs::get_UsedSystemBuffer を減算した場合と同じ値を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IWriteEngine2EventArgs "{27354136-7F64-5B0F-8F00-5D77AFBE261E}"
#usecom global IWriteEngine2EventArgs IID_IWriteEngine2EventArgs "{}"
#comfunc global IWriteEngine2EventArgs_get_StartLba           7 var
#comfunc global IWriteEngine2EventArgs_get_SectorCount        8 var
#comfunc global IWriteEngine2EventArgs_get_LastReadLba        9 var
#comfunc global IWriteEngine2EventArgs_get_LastWrittenLba     10 var
#comfunc global IWriteEngine2EventArgs_get_TotalSystemBuffer  11 var
#comfunc global IWriteEngine2EventArgs_get_UsedSystemBuffer   12 var
#comfunc global IWriteEngine2EventArgs_get_FreeSystemBuffer   13 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IWriteEngine2EventArgs "{27354136-7F64-5B0F-8F00-5D77AFBE261E}"
#usecom global IWriteEngine2EventArgs IID_IWriteEngine2EventArgs "{}"
#comfunc global IWriteEngine2EventArgs_get_StartLba           7 sptr
#comfunc global IWriteEngine2EventArgs_get_SectorCount        8 sptr
#comfunc global IWriteEngine2EventArgs_get_LastReadLba        9 sptr
#comfunc global IWriteEngine2EventArgs_get_LastWrittenLba     10 sptr
#comfunc global IWriteEngine2EventArgs_get_TotalSystemBuffer  11 sptr
#comfunc global IWriteEngine2EventArgs_get_UsedSystemBuffer   12 sptr
#comfunc global IWriteEngine2EventArgs_get_FreeSystemBuffer   13 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。