структура PDH_COUNTER_INFO_W (pdh.h)
Структура PDH_COUNTER_INFO содержит сведения, описывающие свойства счетчика. Эти сведения также включают путь счетчика.
Синтаксис
typedef struct _PDH_COUNTER_INFO_W {
DWORD dwLength;
DWORD dwType;
DWORD CVersion;
DWORD CStatus;
LONG lScale;
LONG lDefaultScale;
DWORD_PTR dwUserData;
DWORD_PTR dwQueryUserData;
LPWSTR szFullPath;
union {
PDH_DATA_ITEM_PATH_ELEMENTS_W DataItemPath;
PDH_COUNTER_PATH_ELEMENTS_W CounterPath;
struct {
LPWSTR szMachineName;
LPWSTR szObjectName;
LPWSTR szInstanceName;
LPWSTR szParentInstance;
DWORD dwInstanceIndex;
LPWSTR szCounterName;
};
};
LPWSTR szExplainText;
DWORD DataBuffer[1];
} PDH_COUNTER_INFO_W, *PPDH_COUNTER_INFO_W;
Члены
dwLength
Размер структуры, включая добавленные строки, в байтах.
dwType
Тип счетчика. Список типов счетчиков см. в разделе Типы счетчиков комплекта развертывания Windows Server 2003. Константы типа счетчиков определяются в Winperf.h.
CVersion
Сведения о версии счетчика. Не используется.
CStatus
Состояние счетчика, указывающее, является ли значение счетчика допустимым. Список возможных значений см. в разделе Проверка возвращаемых значений интерфейса PDH.
lScale
Коэффициент масштабирования, используемый при вычислении отображаемого значения счетчика. Коэффициент масштабирования равен десяти. Допустимый диапазон этого параметра — PDH_MIN_SCALE (–7) (возвращаемое значение — это фактическое значение раз 10–⁷) до PDH_MAX_SCALE (+7) (возвращаемое значение — это фактическое значение раз 10⁺⁷). Нулевое значение присвоит масштабу значение 1, чтобы возвращалось фактическое значение.
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 |