次の方法で共有

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列挙体から次のいずれかの値を受け取る変数へのポインター。

価値 意味
D3D10DDI_COUNTER_TYPE_FLOAT32 単精度浮動小数点数
D3D10DDI_COUNTER_TYPE_UINT16 16 ビット値
D3D10DDI_COUNTER_TYPE_UINT32 32 ビット値
D3D10DDI_COUNTER_TYPE_UINT64 64 ビット値

unnamedParam4

pDescription [out]

カウンター識別子が測定する内容の説明を含む NULL で終わる文字列をドライバーが返すポインター。

unnamedParam5

pActiveCounters [out]

Query が識別するカウンター 識別子の作成に割り当てられる同時にアクティブなカウンターの数を受け取る変数へのポインター。

[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 関数は、pfnSetErrorCb コールバック関数を呼び出して、CheckCounterの Query パラメーターで、デバイスがサポートしていない既知のカウンターを指定した場合に、ERR_UNSUPPORTEDエラー コードを設定できます。

ドライバーは、識別子が範囲内であることを確認するデバイス依存カウンター識別子を検証する必要があります。 また、ドライバーは、Microsoft Direct3D ランタイムが提供する各バッファーに各カウンター文字列をコピーするのに十分な領域が存在することを確認する必要があります。 ドライバーは、pfnSetErrorCb コールバック関数を呼び出して、指定されたバッファーに十分な領域がない場合にE_INVALIDARGエラー コードを設定できます。

ドライバーの CheckCounter 関数は、pfnSetErrorCb コールバック関数を呼び出して、D3DDDIERR_DEVICEREMOVEDエラー コードを設定できません。checkCounter 関数は機能チェック型であるためです。 ドライバーは、D3DDDIERR_DEVICEREMOVEDが存在する場合でも、CheckCounterへの呼び出しに応答するために、デバイスの作成後に十分な情報があることを確認する必要があります。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー d3d10umddi.h (D3d10umddi.h を含む)

関連項目

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb の