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 參數中的,驅動程式可以設定 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 (包括 D3d10umddi.h) |