GetLogIoStatistics 関数 (clfsw32.h)

指定したハンドルに関連付けられている専用または多重化されたログのログ I/O 統計を取得します。 この関数は、特定の種類のログ I/O 統計について、共通ログ ファイル システム (CLFS) に対してクエリを実行します。 多重化されたログでこの関数を呼び出すと、統計が基になるログに関連付けられます。

構文

CLFSUSER_API BOOL GetLogIoStatistics(
  [in]            HANDLE             hLog,
  [in, out]       PVOID              pvStatsBuffer,
  [in]            ULONG              cbStatsBuffer,
  [in]            CLFS_IOSTATS_CLASS eStatsClass,
  [out, optional] PULONG             pcbStatsWritten
);

パラメーター

[in] hLog

CreateLogFile が取得する開いているログ ファイルへのハンドル。 ログ ハンドルは、専用または多重化されたログ ファイルを参照できます。

[in, out] pvStatsBuffer

I/O 統計を受け取るバッファーへのポインター。

このバッファーは、少なくとも I/O 統計パケット ヘッダーと同じ大きさにする必要があります。 詳細については、「 CLFS_IO_STATISTICS_HEADER」を参照してください。

[in] cbStatsBuffer

I/O 統計バッファー pvStatsBuffer のサイズ (バイト単位)。

バッファーが統計パケットに対して十分な大きさでない場合、関数は ERROR_MORE_DATA で失敗します。

[in] eStatsClass

このパラメーターは、現時点では実装されていません。将来の使用のために予約されています。

[out, optional] pcbStatsWritten

pvStatsBuffer に書き込まれる I/O 統計パケットのサイズを受け取る変数へのポインター。

この値は cbStatsBuffer 以下です。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 次の一覧は、考えられるエラー コードを示しています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	clfsw32.h
Library	Clfsw32.lib
[DLL]	Clfsw32.dll

こちらもご覧ください

CLFS_IOSTATS_CLASS

CLFS_IO_STATISTICS_HEADER

一般的なログ ファイル システム関数