METODE ID3D11Device::CheckCounter (d3d11.h)

Dapatkan jenis, nama, unit pengukuran, dan deskripsi penghitung yang ada.

Sintaks

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
);

Parameter

[in] pDesc

Jenis: const D3D11_COUNTER_DESC*

Penunjuk ke deskripsi penghitung (lihat D3D11_COUNTER_DESC). Menentukan informasi penghitung mana yang akan diambil.

[out] pType

Jenis: D3D11_COUNTER_TYPE*

Penunjuk ke jenis data penghitung (lihat D3D11_COUNTER_TYPE). Menentukan jenis data penghitung yang diambil.

[out] pActiveCounters

Jenis: UINT*

Arahkan ke jumlah penghitung perangkat keras yang diperlukan agar jenis penghitung ini dibuat. Semua instans dengan jenis penghitung yang sama menggunakan penghitung perangkat keras yang sama.

[out, optional] szName

Jenis: LPSTR

String yang akan diisi dengan nama singkat untuk penghitung. Mungkin NULL jika aplikasi tidak tertarik pada nama penghitung.

[in, out, optional] pNameLength

Jenis: UINT*

Panjang string yang dikembalikan ke szName. Bisa NULL.

[out, optional] szUnits

Jenis: LPSTR

Nama unit pengukuran penghitung, asalkan memori yang ditunjukkan pointer memiliki ruang yang cukup untuk menahan string. Bisa NULL. String yang dikembalikan akan selalu dalam bahasa Inggris.

[in, out, optional] pUnitsLength

Jenis: UINT*

Panjang string yang dikembalikan ke szUnits. Bisa NULL.

[out, optional] szDescription

Jenis: LPSTR

Deskripsi penghitung, memberikan memori titik penunjuk untuk memiliki ruang yang cukup untuk menahan string. Bisa NULL. String yang dikembalikan akan selalu dalam bahasa Inggris.

[in, out, optional] pDescriptionLength

Jenis: UINT*

Panjang string yang dikembalikan ke szDescription. Bisa NULL.

Mengembalikan nilai

Jenis: HRESULT

Metode ini mengembalikan salah satu Kode Pengembalian Direct3D 11 berikut.

Keterangan

Parameter panjang bisa NULL, yang menunjukkan aplikasi tidak tertarik dengan panjang atau nilai string yang sesuai. Ketika parameter panjang bukan NULL dan string yang sesuai adalah NULL, nilai input parameter panjang diabaikan, dan panjang string yang sesuai (termasuk mengakhiri NULL) akan dikembalikan melalui parameter panjang. Ketika panjang dan parameter yang sesuai baik non-NULL, nilai input panjang diperiksa untuk memastikan ada cukup ruang, dan kemudian panjang string (termasuk mengakhiri karakter NULL ) dilewatkan melalui parameter panjang.

Windows Phone 8: API ini didukung.

Persyaratan

Target Platform	Windows
Header	d3d11.h
Pustaka	D3D11.lib

Lihat juga

ID3D11Device