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 반환 코드 중 하나를 반환합니다.

설명

길이 매개 변수는 NULL일 수 있으며, 이는 애플리케이션이 길이나 해당 문자열 값에 관심이 없음을 나타냅니다. length 매개 변수가 NULL 이 아니고 해당 문자열이 NULL이면 length 매개 변수의 입력 값이 무시되고 해당 문자열의 길이( NULL 종료 포함)가 length 매개 변수를 통해 반환됩니다. length와 해당 매개 변수가 모두 NULL이 아닌 경우 길이 입력 값이 충분한 공간이 있는지 확인한 다음 길이 매개 변수를 통해 문자열 길이( NULL 문자 종료 포함)가 전달됩니다.

Windows Phone 8: 이 API가 지원됩니다.

요구 사항

   
대상 플랫폼 Windows
헤더 d3d11.h
라이브러리 D3D11.lib

추가 정보

ID3D11Device