Метод ID3D11Device::CheckCounter (d3d11.h)

Получите тип, имя, единицы измерения и описание существующего счетчика.

Синтаксис

HRESULT CheckCounter(
  [in]                const D3D11_COUNTER_DESC *pDesc,
  [out]               D3D11_COUNTER_TYPE       *pType,
  [out]               UINT                     *pActiveCounters,
  [out, optional]     LPSTR                    szName,
  [in, out, optional] UINT                     *pNameLength,
  [out, optional]     LPSTR                    szUnits,
  [in, out, optional] UINT                     *pUnitsLength,
  [out, optional]     LPSTR                    szDescription,
  [in, out, optional] UINT                     *pDescriptionLength
);

Параметры

[in] pDesc

Тип: const D3D11_COUNTER_DESC*

Указатель на описание счетчика (см . D3D11_COUNTER_DESC). Указывает, какие сведения счетчика должны быть получены.

[out] pType

Тип: D3D11_COUNTER_TYPE*

Указатель на тип данных счетчика (см . D3D11_COUNTER_TYPE). Указывает тип данных извлекаемого счетчика.

[out] pActiveCounters

Тип: UINT*

Указатель на количество аппаратных счетчиков, необходимых для создания этого типа счетчика. Все экземпляры одного типа счетчика используют одни и те же аппаратные счетчики.

[out, optional] szName

Тип: LPSTR

Строка, заполняемая кратким именем счетчика. Может иметь значение NULL , если приложение не интересует имя счетчика.

[in, out, optional] pNameLength

Тип: UINT*

Длина строки, возвращаемой в szName. Может иметь значение NULL.

[out, optional] szUnits

Тип: LPSTR

Имя единиц, измеряемых счетчиком, при условии, что память, на которая указывает указатель, имеет достаточно места для хранения строки. Может иметь значение NULL. Возвращаемая строка всегда будет на английском языке.

[in, out, optional] pUnitsLength

Тип: UINT*

Длина строки, возвращаемой в szUnits. Может иметь значение NULL.

[out, optional] szDescription

Тип: LPSTR

Описание счетчика при условии, что память, на который указывает указатель, имеет достаточно места для хранения строки. Может иметь значение NULL. Возвращаемая строка всегда будет на английском языке.

[in, out, optional] pDescriptionLength

Тип: UINT*

Длина строки, возвращаемой в szDescription. Может иметь значение NULL.

Возвращаемое значение

Тип: HRESULT

Этот метод возвращает один из следующих кодов возврата Direct3D 11.

Комментарии

Параметры length могут иметь значение NULL, что означает, что приложение не интересует ни длину, ни соответствующее строковое значение. Если параметр length не равен NULL , а соответствующая строка имеет значение NULL, входное значение параметра length игнорируется, а длина соответствующей строки (включая завершающее значение NULL) возвращается через параметр length. Если длина и соответствующий параметр не равны NULL, входное значение длины проверяется, чтобы убедиться, что достаточно места, а затем длина строки (включая завершающий символ NULL ) передается через параметр length.

Windows Phone 8. Этот API поддерживается.

Требования

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

ID3D11Device