ID3D10Device::CheckCounter メソッド (d3d10.h)

型、名前、測定単位、および既存のカウンターの説明を取得します。

構文

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

パラメーター

[in] pDesc

型: const D3D10_COUNTER_DESC*

カウンターの説明へのポインター ( 「D3D10_COUNTER_DESC」を参照)。 取得するカウンター情報を指定します。

[out] pType

種類: D3D10_COUNTER_TYPE*

カウンターのデータ型へのポインター ( 「D3D10_COUNTER_TYPE」を参照)。 取得するカウンターのデータ型を指定します。

[out] pActiveCounters

型: UINT*

このカウンターの種類を作成するために必要なハードウェア カウンターの数へのポインター。 同じカウンターの種類のすべてのインスタンスで、同じハードウェア カウンターが使用されます。

[out] szName

種類: LPSTR

カウンターの短い名前で入力する文字列。 アプリケーションがカウンターの名前に関心がない場合は 、NULL を指定できます。

[in, out] pNameLength

型: UINT*

szName に返される文字列の長さ。 NULL を指定できます。

[out] szUnits

種類: LPSTR

ポインターが指すメモリに文字列を保持するのに十分なスペースがある場合、カウンターが測定する単位の名前。 NULL を指定できます。 返される文字列は常に英語になります。

[in, out] pUnitsLength

型: UINT*

szUnits に返される文字列の長さ。 NULL を指定できます。

[out] szDescription

種類: LPSTR

ポインターが指すメモリに文字列を保持するのに十分なスペースがある場合は、カウンターの説明。 NULL を指定できます。 返される文字列は常に英語になります。

[in, out] pDescriptionLength

型: UINT*

szDescription に返される文字列の長さ。 NULL を指定できます。

戻り値

種類: HRESULT

このメソッドは、次の Direct3D 10 リターン コードのいずれかを返します。

解説

長さパラメーターには NULL を指定できます。これは、アプリケーションが長さや対応する文字列値に関心を持たないことを示します。 長さパラメーターが NULL 以外で、対応する文字列が NULL の場合、length パラメーターの入力値は無視され、対応する文字列の長さ ( 終端の NULL を含む) が length パラメーターを介して返されます。 length と対応するパラメーターの両方が NULL 以外の場合は、十分なスペースがあることを確認するために length の入力値がチェックされ、文字列の長さ (終端 の NULL 文字を含む) が length パラメーターを介して渡されます。

必要条件

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

関連項目

ID3D10Device インターフェイス