StopWatchMode-Funktion (shlwapi.h)

  • Artikel

[StopWatchMode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Ruft einen Wert ab, der angibt, welche Leistungsinformationen protokolliert werden.

Syntax

DWORD StopWatchMode();

Rückgabewert

Art: DWORD

Der aktuelle Stoppuhrmodus. Wenn keine Leistungsinformationen protokolliert werden, ist der Stoppmodus null. Andernfalls besteht sie aus einem oder mehreren der folgenden Flags.

Flag Wert BESCHREIBUNG
SPMODE_SHELL 0x00000001 Protokolliert ausgewählte Windows-Explorer-Aktionen.
SPMODE_DEBUGOUT 0x00000002 Hat keinerlei Auswirkungen.
SPMODE_TEST 0x00000004 Hat keinerlei Auswirkungen.
SPMODE_BROWSER 0x00000008 Protokolliert ausgewählte Aktivitäten des Windows-Explorer- oder Internet-Explorer-Browserframes. Dieses Flag kann nicht mit SPMODE_EVENTTRACE kombiniert werden.
SPMODE_FLUSH 0x00000010 Hat keinerlei Auswirkungen.
SPMODE_EVENT 0x00000020 Hat keinerlei Auswirkungen.
SPMODE_MSVM 0x00000040 Protokolliert ausgewählte Zeiten für die Initialisierung der Microsoft-VM.
SPMODE_FORMATTEXT 0x00000080 Windows 2000: Gibt im Protokoll an, welche Einträge sich auf den Browserframe auswirken.

Windows XP: Hat keine Auswirkung.
SPMODE_PROFILE 0x00000100 Hat keinerlei Auswirkungen.
SPMODE_DEBUGBREAK 0x00000200 Der Debugger wird nach der Erstellung jedes Protokolleintrags in den Debugger eingegliedert. Wenn kein Debugger verfügbar ist, wird das Programm mit einer STATUS_BREAKPOINT Ausnahme angehalten.
SPMODE_MSGTRACE 0x00000400 Aktiviert Nachrichtenleistungsprotokolle.
SPMODE_PERFTAGS 0x00000800 Hat keinerlei Auswirkungen.
SPMODE_MEMWATCH 0x00001000 Hat keinerlei Auswirkungen.
SPMODE_DBMON 0x00002000 Hat keinerlei Auswirkungen.
SPMODE_MULTISTOP 0x00004000 Protokolliert alle "Stop"-Vorgänge, auch wenn nur ein entsprechender "Start" vorhanden ist.
SPMODE_EVENTTRACE 0x00008000 Protokolliert ausgewählte Aktivitäten der MSHTML-Rendering-Engine. Dieses Flag kann nicht mit SPMODE_BROWSER kombiniert werden.

Hinweise

Um die Leistungsprotokollierung zu aktivieren, legen Sie den folgenden REG_DWORD Registrierungswert fest. Sie sollten den Computer neu starten, nachdem Sie diesen Wert festgelegt haben, um sicherzustellen, dass die Änderung wirksam wird.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  Performance
                     Mode

Die Informationen im Leistungsprotokoll sind für interne Messzwecke gedacht und die genauen Inhalte ändern sich regelmäßig. Die Leistungsprotokollierung in ihrer aktuellen Form kann sich in Zukunft ändern.

Das Aktivieren der Leistungsprotokollierung beeinträchtigt die Leistung geringfügig.

Hinweis Bei Verwendung von Windows XP mit Service Pack 2 (SP2) und höher werden Leistungsdaten für einen Prozess erst gesammelt, wenn dieser Die StopWatchMode-Funktion zum ersten Mal aufruft, auch wenn der obige Registrierungswert auf einen Wert ungleich null festgelegt wurde.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
DLL Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

StopWatchFlush