SetTextFilterSize 函式會設定單色卷積篩選條件的寬度和高度。
語法
PFND3D10DDI_SETTEXTFILTERSIZE Pfnd3d10ddiSettextfiltersize;
void Pfnd3d10ddiSettextfiltersize(
D3D10DDI_HDEVICE unnamedParam1,
UINT unnamedParam2,
UINT unnamedParam3
)
{...}
參數
unnamedParam1
hDevice [in]
顯示裝置的句柄（圖形內容）。
unnamedParam2
Width [in]
單色卷積篩選的寬度。 寬度可以從 1 到 7 紋素。
unnamedParam3
Height [in]
單色卷積篩選的高度。 高度可以是 1 到 7 個紋素。
傳回值
沒有
言論
驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。
核心維度所需的樣本數目實際上是 （Width + 1） x （Height + 1），這可以從 4 到 64 個樣本。 這些設定適用於所有已設定為使用 D3D10_DDI_FILTER 列舉D3D10_DDI_FILTER_TEXT_1BIT篩選條件的取樣器。
SetTextFilterSize 可確保 Width 和 Height 參數中提供的值在範圍內。 Width 和 Height 的預設值一開始都是 1。 驅動程式必須在裝置建立期間設定這些預設值。
除了D3DDDIERR_DEVICEREMOVED以外，驅動程式不應該發生任何錯誤。 因此，如果驅動程式通過任何錯誤，除了 D3DDDIERR_DEVICEREMOVED 之外，在呼叫 pfnSetErrorCb 函式時，Direct3D 運行時間會判斷錯誤是否重要。 即使移除裝置，驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED。 不過，如果裝置移除干擾了 SetTextFilterSize 的作業（通常不應該發生），驅動程式可以傳回D3DDDIERR_DEVICEREMOVED。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
| 目標平臺 | 桌面 |
| 標頭 | d3d10umddi.h （包括 D3d10umddi.h） |