PFND3D10DDI_CHECKCOUNTER 콜백 함수(d3d10umddi.h)

CheckCounter 함수는 카운터를 설명하는 정보를 검색합니다.

구문

PFND3D10DDI_CHECKCOUNTER Pfnd3d10ddiCheckcounter;

void Pfnd3d10ddiCheckcounter(
            D3D10DDI_HDEVICE unnamedParam1,
            D3D10DDI_QUERY unnamedParam2,
            D3D10DDI_COUNTER_TYPE *unnamedParam3,
            UINT *unnamedParam4,
            LPSTR unnamedParam5,
  [in, out] UINT *pNameLength,
            LPSTR unnamedParam7,
  [in, out] UINT *pUnitsLength,
            LPSTR unnamedParam9,
  [in, out] UINT *pDescriptionLength
)
{...}

매개 변수

unnamedParam1

hDevice [in]

디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.

unnamedParam2

쿼리 [in]

정보가 검색되는 카운터 식별자를 식별하는 D3D10DDI_QUERY 형식의 값입니다.

unnamedParam3

pCounterType [out]

카운터가 출력하는 데이터 형식을 식별하는 D3D10DDI_COUNTER_TYPE 열거형에서 다음 값 중 하나를 수신하는 변수에 대한 포인터입니다.

unnamedParam4

pDescription [out]

드라이버가 카운터 식별자가 측정하는 내용에 대한 설명을 포함하는 NULL로 끝나는 문자열을 반환하는 포인터입니다.

unnamedParam5

pActiveCounters [out]

쿼리에서 식별하는 카운터 식별자를 만들기 위해 할당된 동시에 활성 카운터 수를 수신하는 변수에 대한 포인터입니다.

[in, out] pNameLength

pName 매개 변수가 지정하는 NULL로 끝나는 문자열의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

unnamedParam7

pName [out]

드라이버가 카운터 식별자의 이름을 포함하는 에 NULL로 끝나는 문자열을 반환하는 포인터입니다.

[in, out] pUnitsLength

pUnits 매개 변수가 지정하는 NULL로 끝나는 문자열의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

unnamedParam9

pUnits [out]

드라이버가 카운터 식별자가 측정하는 단위의 이름을 포함하는 NULL로 끝나는 문자열을 반환하는 포인터입니다.

[in, out] pDescriptionLength

pDescription 매개 변수가 지정하는 NULL로 끝나는 문자열의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

반환 값

없음

설명

드라이버는 pfnSetErrorCb 콜백 함수를 사용하여 오류 코드를 설정할 수 있습니다.

CheckCounter의 Query 매개 변수가 디바이스에서 지원하지 않는 잘 알려진 카운터를 지정하는 경우 드라이버의 CheckCounter 함수는 pfnSetErrorCb 콜백 함수를 호출하여 ERR_UNSUPPORTED 오류 코드를 설정할 수 있습니다.

드라이버는 디바이스 종속 카운터 식별자의 유효성을 검사하여 식별자가 범위 내에 있는지 확인해야 합니다. 또한 드라이버는 Microsoft Direct3D 런타임에서 제공하는 각 버퍼에 각 카운터 문자열을 복사할 수 있는 충분한 공간이 있는지 확인해야 합니다. 드라이버는 제공된 버퍼에 충분한 공간이 없는 경우 pfnSetErrorCb 콜백 함수를 호출하여 E_INVALIDARG 오류 코드를 설정할 수 있습니다.

CheckCounter는 기능 검사 함수 유형이므로 드라이버의 CheckCounter 함수는 pfnSetErrorCb 콜백 함수를 호출하여 D3DDDIERR_DEVICEREMOVED 오류 코드를 설정할 수 없습니다. 드라이버는 디바이스를 만든 후 D3DDDIERR_DEVICEREMOVED 있는 경우에도 CheckCounter 호출에 응답할 수 있는 충분한 정보가 있는지 확인해야 합니다.

요구 사항

추가 정보

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb