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 或更高版本) |