PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS回呼函式 (d3d10umddi.h)
PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS 擷取裝置針對指定樣本數目支援的質量等級。
語法
PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3dwddm13DdiCheckmultisamplequalitylevels;
void Pfnd3dwddm13DdiCheckmultisamplequalitylevels(
D3D10DDI_HDEVICE hDevice,
DXGI_FORMAT Format,
UINT SampleCount,
UINT Flags,
UINT *pNumQualityLevels
)
{...}
參數
hDevice
顯示裝置的句柄 (圖形內容) 。
Format
型 別為 DXGI_FORMAT 的值，指出執行檢查的轉譯目標格式。
SampleCount
要擷取品質等級的樣本數目。
Flags
使用位 OR 運算結合 D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG 值的組合。
pNumQualityLevels
變數的指標，可接收裝置針對指定樣本數目所支援的質量等級。
傳回值
無
備註
驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。 如果 Format 參數中的格式不存在，或 pNumQualityLevels 參數為 NULL，則驅動程式可以設定E_INVALIDARG。
如果裝置不支援具有 SampleCount 參數中所指定樣本數目的多個取樣，則使用者模式顯示驅動程式應該在 pNumQualityLevels 參數指向的變數中傳回零。
當驅動程式在 pNumQualityLevels 指向的變數中傳回 1 或更多時，驅動程式會指出指定樣本計數可用的裝置特定取樣變化數目。 例如，如果驅動程式傳回 3，則品質等級 0、1 和 2 可用來建立具有指定樣本計數的資源。 裝置製造商會定義這些品質等級，Microsoft Direct3D 運行時間無法查詢。 不過，固定樣本計數上的不同品質層級可能會參考範例位置的不同空間配置，或解析的不同方法。
如果驅動程式在 SampleCount 中收到 1，驅動程式一律會在 pNumQualityLevels 指向的變數中傳回 1。
如果驅動程式在 SampleCount 中收到 0 或大於 32，驅動程式一律會在 pNumQualityLevels 指向的變數中傳回 0。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8.1 (WDDM 1.3) |
| 最低支援的伺服器 | Windows Server 2012 R2 |
| 目標平台 | 桌面 |
| 標頭 | d3d10umddi.h (include D3d10umddi.h) |