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 オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header d3d10umddi.h (D3d10umddi.h を含む)

こちらもご覧ください

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb