Erstellen anderer Registrierungseinträge

Die OpenPerformanceData-Funktion der Leistungs-DLL nimmt ein Zeichenfolgenargument als Eingabe an. Um ihrer geöffneten Funktion eine Eingabezeichenfolge bereitzustellen, fügen Sie einen Verknüpfungsschlüssel unter Ihren Dienstschlüssel ein. Der Verknüpfungsschlüssel enthält einen Exportwert. Legen Sie die Wertdaten für Export auf die Eingabezeichenfolge fest, die Sie an Ihre geöffnete Funktion übergeben möchten. Der Datentyp von Export ist REG MULTI _ _ SZ.

Wenn Export nicht definiert ist (Export ist optional), übergibt das System NULL an Ihre OpenPerformanceData-Funktion.

Wenn mehrere Anwendungen dieselbe Leistungs-DLL gemeinsam nutzen, enthält jede Anwendung in der Regel einen Verknüpfungsschlüssel und einen Exportwert, um Kontext für die Anwendung bereitzustellen, die die DLL aufruft.

Im Folgenden werden die Registrierungseinträge angezeigt:

HKEY_LOCAL_MACHINE
   \SYSTEM
      \CurrentControlSet
         \Services
            \application-name-1
               \Linkage
                  Export = app-1 context strings
               \Performance
                  Library = perfctrs.dll
            \application-name-2
               \Linkage
                  Export = app-2 context strings
               \Performance
                  Library = perfctrs.dll

Standardmäßig müssen die Funktionen OpenPerformanceData und CollectPerformanceData der Leistungs-DLL innerhalb von 10.000 Millisekunden zurückgeben. Wenn nicht, verwendet das System nicht die Daten, die von der DLL zurückgegeben werden. Die Anwendung kann den Timeoutwert erhöhen oder verringern, indem sie einen Open Timeout- oder Collect Timeout-Registrierungswert unter ihrem Leistungsschlüssel angibt, wie im folgenden Beispiel gezeigt.

HKEY_LOCAL_MACHINE
   \SYSTEM
      \CurrentControlSet
         \Services
            \application-name
               \Performance
                  Open Timeout = Timeout value for your open function, in milliseconds
                  Collect Timeout = Timeout value for your collect function, in milliseconds

Zum Abrufen der Leistungsdaten für einige Anwendungen (die Leistungsindikatoren mithilfe der DeviceIoControl-Funktion zurückgeben), müssen Sie die CreateFile-Funktion verwenden, um das gerät zu öffnen, das der Anwendung zugeordnet ist. In diesem Fall muss der in CreateFile angegebene Name auch im Knoten DOS-Geräte der Registrierung installiert werden, wie hier gezeigt:

HKEY_LOCAL_MACHINE
   \SYSTEM
      \CurrentControlSet
         \Control
            \Session Manager
               \DOS Devices