次の方法で共有


PFND3D10DDI_CREATESAMPLER コールバック関数 (d3d10umddi.h)

CreateSampler 関数はサンプラーを作成します。

構文

PFND3D10DDI_CREATESAMPLER Pfnd3d10ddiCreatesampler;

void Pfnd3d10ddiCreatesampler(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_SAMPLER_DESC *unnamedParam2,
  D3D10DDI_HSAMPLER unnamedParam3,
  D3D10DDI_HRTSAMPLER unnamedParam4
)
{...}

パラメーター

unnamedParam1

hDevice [in]

ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。

unnamedParam2

pSamplerDesc [in]

ユーザー モード ディスプレイ ドライバーがサンプラーの作成に使用するパラメーターを記述する D3D10_DDI_SAMPLER_DESC 構造体へのポインター。

unnamedParam3

hSampler [in]

サンプラーのドライバーのプライベート データへのハンドル。 ドライバーは、Microsoft Direct3D ランタイムがドライバーの CalcPrivateSamplerSize 関数への呼び出しからプライベート データに割り当てる必要があるメモリ領域のサイズ (バイト単位) を返します。 ハンドルは、実際には単なるメモリ領域へのポインターであり、ドライバーが要求したサイズです。 ドライバーは、このメモリ領域を使用して、サンプラー オブジェクトに関連する内部データ構造を格納します。

unnamedParam4

hRTSampler [in]

ドライバーが Direct3D ランタイムに呼び出す場合にいつでも使用する必要があるサンプラーへのハンドル。

戻り値

何一つ

備考

ドライバーは、pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。

ドライバーは、pfnSetErrorCb 関数の呼び出しでE_OUTOFMEMORY (ドライバーのメモリ不足の場合) またはD3DDDIERR_DEVICEREMOVED (デバイスが削除されている場合) を渡すことができます。 Direct3D ランタイムは、他のエラーが重大であると判断します。 ドライバーがD3DDDIERR_DEVICEREMOVEDなどのエラーを渡した場合、Direct3D ランタイムはハンドルが無効であると判断します。そのため、ランタイムは DestroySampler 関数を呼び出して、hSampler パラメーターが指定するハンドルを破棄しません。

ユーザー モード ディスプレイ ドライバーは、一度に 4,096 個を超えるサンプラー オブジェクトの一意のインスタンスをデバイスに作成する必要はありません。

必要条件

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

関連項目

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb