Поделиться через


структура PDH_COUNTER_INFO_A (pdh.h)

Структура PDH_COUNTER_INFO содержит сведения, описывающие свойства счетчика. Эти сведения также включают путь счетчика.

Синтаксис

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;

Члены

dwLength

Размер структуры, включая добавленные строки, в байтах.

dwType

Тип счетчика. Список типов счетчиков см. в разделе Типы счетчиков комплекта развертывания Windows Server 2003. Константы типа счетчика определяются в Winperf.h.

CVersion

Сведения о версии счетчика. Не используется.

CStatus

Состояние счетчика, указывающее, является ли значение счетчика допустимым. Список возможных значений см. в разделе Проверка возвращаемых значений интерфейса PDH.

lScale

Коэффициент масштабирования, используемый при вычислении отображаемого значения счетчика. Коэффициент масштабирования равен десяти. Допустимый диапазон этого параметра — PDH_MIN_SCALE (–7) (возвращаемое значение — это фактическое значение раз 10⁷) до PDH_MAX_SCALE (+7) (возвращаемое значение — это фактическое значение раз 10⁺⁷). Значение, равное нулю, присвоит масштабу единицу, чтобы возвращалось фактическое значение.

lDefaultScale

Коэффициент масштабирования по умолчанию, предложенный поставщиком счетчика.

dwUserData

Значение, переданное в параметре dwUserData при вызове PdhAddCounter.

dwQueryUserData

Значение, переданное в параметре dwUserData при вызове PdhOpenQuery.

szFullPath

Строка, завершающаяся значением NULL, указывающая полный путь счетчика. Строка следует этой структуре в памяти.

DataItemPath

Структура PDH_DATA_ITEM_PATH_ELEMENTS . Не используется.

CounterPath

Структура PDH_COUNTER_PATH_ELEMENTS .

szMachineName

Строка, завершающаяся значением NULL, содержащая имя компьютера, указанного в пути счетчика. Имеет значение NULL, если путь не указывает компьютер. Строка следует этой структуре в памяти.

szObjectName

Строка, завершающаяся значением NULL, содержащая имя объекта производительности, указанного в пути счетчика. Строка следует этой структуре в памяти.

szInstanceName

Строка, завершающаяся значением NULL, содержащая имя экземпляра объекта, указанного в пути счетчика. Имеет значение NULL, если в пути не указан экземпляр. Строка следует этой структуре в памяти.

szParentInstance

Строка, завершающаяся значением NULL, которая содержит имя родительского экземпляра, указанное в пути счетчика. Имеет значение NULL, если путь не указывает родительский экземпляр. Строка следует этой структуре в памяти.

dwInstanceIndex

Индекс экземпляра, указанный в пути счетчика. Имеет значение 0, если путь не указывает индекс экземпляра.

szCounterName

Строка, завершающаяся значением NULL, содержащая имя счетчика. Строка следует этой структуре в памяти.

szExplainText

Текст справки, описывающий счетчик. Имеет значение NULL , если источником является файл журнала.

DataBuffer[1]

Начало строковых данных, добавляемых в структуру.

Комментарии

При выделении памяти для этой структуры выделите достаточно памяти для строк элементов, таких как szCounterName, которые добавляются в конец этой структуры.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть pdh.h

См. также раздел

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo