PDH_COUNTER_INFO_A-Struktur (pdh.h)

  • Artikel

Die PDH_COUNTER_INFO-Struktur enthält Informationen, die die Eigenschaften eines Zählers beschreiben. Diese Informationen enthalten auch den Zählerpfad.

Syntax

typedef struct _PDH_COUNTER_INFO_A {
  DWORD     dwLength;
  DWORD     dwType;
  DWORD     CVersion;
  DWORD     CStatus;
  LONG      lScale;
  LONG      lDefaultScale;
  DWORD_PTR dwUserData;
  DWORD_PTR dwQueryUserData;
  LPSTR     szFullPath;
  union {
    PDH_DATA_ITEM_PATH_ELEMENTS_A DataItemPath;
    PDH_COUNTER_PATH_ELEMENTS_A   CounterPath;
    struct {
      LPSTR szMachineName;
      LPSTR szObjectName;
      LPSTR szInstanceName;
      LPSTR szParentInstance;
      DWORD dwInstanceIndex;
      LPSTR szCounterName;
    };
  };
  LPSTR     szExplainText;
  DWORD     DataBuffer[1];
} PDH_COUNTER_INFO_A, *PPDH_COUNTER_INFO_A;

Member

dwLength

Größe der Struktur, einschließlich der angefügten Zeichenfolgen, in Bytes.

dwType

Zählertyp. Eine Liste der Leistungsindikatorentypen finden Sie im Abschnitt Leistungsindikatorentypen des Windows Server 2003 Deployment Kit. Die Leistungsindikatortypkonstanten sind in Winperf.h definiert.

CVersion

Informationen zur Leistungsversion. Wird nicht verwendet.

CStatus

Zähler status, der angibt, ob der Zählerwert gültig ist. Eine Liste der möglichen Werte finden Sie unter Überprüfen von PDH-Schnittstellenrückgabewerten.

lScale

Skalierungsfaktor, der beim Berechnen des anzeigebaren Werts des Zählers verwendet werden soll. Der Skalierungsfaktor ist eine Leistung von zehn. Der gültige Bereich dieses Parameters ist PDH_MIN_SCALE (–7) (der zurückgegebene Wert ist der tatsächliche Wert mal 10–⁷) bis PDH_MAX_SCALE (+7) (der zurückgegebene Wert ist der tatsächliche Wert mal 10⁺⁷). Ein Wert von 0 legt die Skalierung auf 1 fest, sodass der tatsächliche Wert zurückgegeben wird.

lDefaultScale

Standardskalierungsfaktor, wie vom Anbieter des Zählers vorgeschlagen.

dwUserData

Der Wert, der beim Aufrufen von PdhAddCounter im dwUserData-Parameter übergeben wird.

dwQueryUserData

Der Wert, der beim Aufrufen von PdhOpenQuery im dwUserData-Parameter übergeben wird.

szFullPath

Null-Zeichenfolge, die den vollständigen Zählerpfad angibt. Die Zeichenfolge folgt dieser Struktur im Arbeitsspeicher.

DataItemPath

Eine PDH_DATA_ITEM_PATH_ELEMENTS-Struktur . Wird nicht verwendet.

CounterPath

Eine PDH_COUNTER_PATH_ELEMENTS-Struktur .

szMachineName

Null-beendete Zeichenfolge, die den Namen des Computers enthält, der im Indikatorpfad angegeben ist. Ist NULL, wenn der Pfad keinen Computer angibt. Die Zeichenfolge folgt dieser Struktur im Arbeitsspeicher.

szObjectName

Null-beendete Zeichenfolge, die den Namen des im Leistungsindikatorpfad angegebenen Leistungsobjekts enthält. Die Zeichenfolge folgt dieser Struktur im Arbeitsspeicher.

szInstanceName

Null-beendete Zeichenfolge, die den Namen des Objekts enthält, instance im Leistungsindikatorpfad angegeben. Ist NULL, wenn der Pfad keine instance angibt. Die Zeichenfolge folgt dieser Struktur im Arbeitsspeicher.

szParentInstance

Null-beendete Zeichenfolge, die den Namen des übergeordneten instance im Leistungsindikatorpfad enthält. Ist NULL, wenn der Pfad kein übergeordnetes instance angibt. Die Zeichenfolge folgt dieser Struktur im Arbeitsspeicher.

dwInstanceIndex

Der im Indikatorpfad angegebene Instanzindex. Ist 0, wenn der Pfad keinen instance Index angibt.

szCounterName

Null-beendete Zeichenfolge, die den Zählernamen enthält. Die Zeichenfolge folgt dieser Struktur im Arbeitsspeicher.

szExplainText

Hilfetext, der den Leistungsindikator beschreibt. Ist NULL , wenn die Quelle eine Protokolldatei ist.

DataBuffer[1]

Start der Zeichenfolgendaten, die an die Struktur angefügt werden.

Hinweise

Wenn Sie Arbeitsspeicher für diese Struktur zuweisen, weisen Sie genügend Arbeitsspeicher für die Memberzeichenfolgen zu, z. B . szCounterName, die an das Ende dieser Struktur angefügt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile pdh.h

Weitere Informationen

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo