StopWatchMode 函数 (shlwapi.h)

[StopWatchMode 可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]

检索一个值,该值指示要记录的性能信息。

语法

DWORD StopWatchMode();

返回值

类型:DWORD

当前秒表模式。 如果未记录性能信息,则秒表模式为零。 否则,它由以下一个或多个标志组成。

标志 说明
SPMODE_SHELL 0x00000001 记录所选 Windows 资源管理器操作。
SPMODE_DEBUGOUT 0x00000002 无效。
SPMODE_TEST 0x00000004 无效。
SPMODE_BROWSER 0x00000008 记录 Windows 资源管理器或 Internet Explorer 浏览器框架的选定活动。 此标志不能与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 记录所有“停止”操作,即使只有一个匹配的“start”操作。
SPMODE_EVENTTRACE 0x00008000 记录 MSHTML 呈现引擎的选定活动。 此标志不能与SPMODE_BROWSER结合使用。

注解

若要启用性能日志记录,请设置以下REG_DWORD注册表值。 设置此值后,应重新启动计算机,以确保更改已生效。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  Performance
                     Mode

性能日志中的信息用于内部测量目的,确切内容会定期更改。 其当前格式的性能日志记录将来可能会更改。

启用性能日志记录会稍微降低性能。

注意 将 Windows XP 与 Service Pack 2 (SP2) 及更高版本配合使用时,在进程首次调用 StopWatchMode 函数之前,不会收集进程的性能数据,即使上述注册表值已设置为非零值。
 

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
DLL Shlwapi.dll (5.0 或更高版本)

另请参阅

StopWatchFlush