StopWatchMode 関数 (shlwapi.h)
[StopWatchMode は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。
ログに記録されているパフォーマンス情報を示す値を取得します。
構文
DWORD StopWatchMode();
戻り値
型: DWORD
現在のストップウォッチ モード。 パフォーマンス情報がログに記録されていない場合、ストップウォッチ モードは 0 になります。 それ以外の場合は、次のフラグの 1 つ以上で構成されます。
フラグ | 値 | 説明 |
---|---|---|
SPMODE_SHELL | 0x00000001 | 選択した Windows エクスプローラー アクションをログに記録します。 |
SPMODE_DEBUGOUT | 0x00000002 | 機能しません。 |
SPMODE_TEST | 0x00000004 | 機能しません。 |
SPMODE_BROWSER | 0x00000008 | Windows エクスプローラーまたはインターネット エクスプローラー ブラウザー フレームの選択したアクティビティをログに記録します。 このフラグをSPMODE_EVENTTRACEと組み合わせることはできません。 |
SPMODE_FLUSH | 0x00000010 | 機能しません。 |
SPMODE_EVENT | 0x00000020 | 機能しません。 |
SPMODE_MSVM | 0x00000040 | Microsoft VM を初期化するために選択した時刻をログに記録します。 |
SPMODE_FORMATTEXT | 0x00000080 |
Windows 2000: ブラウザー フレームに影響を与えるエントリをログに示します。
Windows XP: 効果はありません。 |
SPMODE_PROFILE | 0x00000100 | 機能しません。 |
SPMODE_DEBUGBREAK | 0x00000200 | 各ログ エントリが作成された後、デバッガーに中断します。 デバッガーが使用できない場合、プログラムはSTATUS_BREAKPOINT例外で停止します。 |
SPMODE_MSGTRACE | 0x00000400 | メッセージ パフォーマンス ログを有効にします。 |
SPMODE_PERFTAGS | 0x00000800 | 機能しません。 |
SPMODE_MEMWATCH | 0x00001000 | 機能しません。 |
SPMODE_DBMON | 0x00002000 | 機能しません。 |
SPMODE_MULTISTOP | 0x00004000 | 一致する "開始" が 1 つしかない場合でも、すべての "停止" 操作をログに記録します。 |
SPMODE_EVENTTRACE | 0x00008000 | MSHTML レンダリング エンジンの選択したアクティビティをログに記録します。 このフラグをSPMODE_BROWSERと組み合わせることはできません。 |
解説
パフォーマンス ログを有効にするには、次のREG_DWORDレジストリ値を設定します。 この値を設定した後にコンピューターを再起動して、変更が有効になっていることを確認する必要があります。
HKEY_LOCAL_MACHINE Software Microsoft Windows CurrentVersion Explorer Performance Mode
パフォーマンス ログの情報は内部測定を目的としており、正確な内容は定期的に変更されます。 現在の形式のパフォーマンス ログは、今後変更される可能性があります。
パフォーマンス ログを有効にすると、パフォーマンスが若干低下します。
メモ Service Pack 2 (SP2) 以降で Windows XP を使用する場合、上記のレジストリ値が 0 以外の値に設定されている場合でも、そのプロセスが StopWatchMode 関数を初めて呼び出すまで、プロセスのパフォーマンス データは収集されません。
要件
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | shlwapi.h |
[DLL] | Shlwapi.dll (バージョン 5.0 以降) |