структура 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 |