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 パラメーターを介して返されます。 length と対応するパラメーターの両方が NULL 以外の場合は、十分なスペースがあることを確認するために length の入力値がチェックされ、文字列の長さ ( 終端の NULL 文字を含む) が length パラメーターを介して渡されます。

Windows Phone 8: この API はサポートされています。

必要条件

対象プラットフォーム	Windows
ヘッダー	d3d11.h
Library	D3D11.lib

関連項目

ID3D11Device