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 以降)

関連項目

StopWatchFlush