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 回呼函式來設定錯誤碼。

如果驅動程式用盡記憶體) 或D3DDDIERR_DEVICEREMOVED (装置已在 pfnSetErrorCb 函式呼叫中移除) ，則驅動程式可以傳遞E_OUTOFMEMORY (。 Direct3D 運行時間會判斷任何其他錯誤都很重要。 如果驅動程式通過任何錯誤，包括D3DDDIERR_DEVICEREMOVED，Direct3D 運行時間會判斷句柄無效;因此，運行時間不會呼叫 DestroySampler 函式，以終結 hSampler 參數所指定的句柄。

使用者模式顯示驅動程式不需要一次在裝置上建立超過 4,096 個取樣器物件的唯一實例。

規格需求

另請參閱

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb