Метод ID3D10Device::CheckCounter (d3d10.h)
Получите тип, имя, единицы измерения и описание существующего счетчика.
Синтаксис
HRESULT CheckCounter(
[in] const D3D10_COUNTER_DESC *pDesc,
[out] D3D10_COUNTER_TYPE *pType,
[out] UINT *pActiveCounters,
[out] LPSTR szName,
[in, out] UINT *pNameLength,
[out] LPSTR szUnits,
[in, out] UINT *pUnitsLength,
[out] LPSTR szDescription,
[in, out] UINT *pDescriptionLength
);
Параметры
[in] pDesc
Тип: const D3D10_COUNTER_DESC*
Указатель на описание счетчика (см . D3D10_COUNTER_DESC). Указывает, какие сведения счетчика должны быть получены.
[out] pType
Тип: D3D10_COUNTER_TYPE*
Указатель на тип данных счетчика (см . D3D10_COUNTER_TYPE). Указывает тип данных извлекаемого счетчика.
[out] pActiveCounters
Тип: UINT*
Указатель на количество аппаратных счетчиков, необходимых для создания этого типа счетчика. Все экземпляры одного типа счетчика используют одни и те же аппаратные счетчики.
[out] szName
Тип: LPSTR
Строка, заполняемая кратким именем счетчика. Может иметь значение NULL , если приложение не интересует имя счетчика.
[in, out] pNameLength
Тип: UINT*
Длина строки, возвращаемой в szName. Может иметь значение NULL.
[out] szUnits
Тип: LPSTR
Имя единиц, измеряемых счетчиком, при условии, что память, на которая указывает указатель, имеет достаточно места для хранения строки. Может иметь значение NULL. Возвращаемая строка всегда будет на английском языке.
[in, out] pUnitsLength
Тип: UINT*
Длина строки, возвращаемой в szUnits. Может иметь значение NULL.
[out] szDescription
Тип: LPSTR
Описание счетчика при условии, что память, на который указывает указатель, имеет достаточно места для хранения строки. Может иметь значение NULL. Возвращаемая строка всегда будет на английском языке.
[in, out] pDescriptionLength
Тип: UINT*
Длина строки, возвращаемой в szDescription. Может иметь значение NULL.
Возвращаемое значение
Тип: HRESULT
Этот метод возвращает один из следующих кодов возврата Direct3D 10.
Комментарии
Параметры length могут иметь значение NULL, что означает, что приложение не интересует ни длину, ни соответствующее строковое значение. Если параметр length не равен NULL , а соответствующая строка имеет значение NULL, входное значение параметра length игнорируется, а длина соответствующей строки (включая завершающее значение NULL) возвращается через параметр length. Если длина и соответствующий параметр не равны NULL, входное значение длины проверяется, чтобы убедиться, что достаточно места, а затем длина строки (включая завершающий символ NULL ) передается через параметр length.
Требования
| Целевая платформа | Windows |
| Header | d3d10.h |
| Библиотека | D3D10.lib |