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） |