PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS回呼函式 (d3d10umddi.h)

  • 發行項

CheckMultisampleQualityLevels 函式會擷取裝置針對指定樣本數目所支援的質量等級數目。

語法

PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;

void Pfnd3d10ddiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT unnamedParam3,
  UINT *unnamedParam4
)
{...}

參數

unnamedParam1

hDevice [in]

顯示裝置的句柄 (圖形內容) 。

unnamedParam2

格式 [in]

DXGI_FORMAT型別值，指出執行檢查的轉譯目標格式。

unnamedParam3

SampleCount [in]

要擷取品質等級的樣本數目。

unnamedParam4

pNumQualityLevels [out]

變數的指標，可接收裝置針對指定樣本數目所支援的質量等級。

傳回值

無

備註

驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。 如果 Format 參數中的格式不存在或 pNumQualityLevels 參數為 NULL，則驅動程式可以設定E_INVALIDARG。

如果裝置不支援具有 SampleCount 參數中指定的樣本數目的多個取樣，則使用者模式顯示驅動程式應該會在 pNumQualityLevels 參數指向的變數中傳回 0。

當驅動程式在 pNumQualityLevels 指向的變數中傳回 1 或更多時，驅動程式會指出指定樣本計數可用的裝置特定取樣變化數目。 例如，如果驅動程式傳回 3，則品質等級 0、1 和 2 可用來建立具有指定樣本計數的資源。 裝置製造商會定義這些品質等級，Microsoft Direct3D 運行時間無法查詢。 不過，固定樣本計數上的不同品質層級可能會參考範例位置的不同空間配置，或解析的不同方法。

如果驅動程式在 SampleCount 中收到 1，驅動程式一律會在 pNumQualityLevels 指向的變數中傳回 1。

如果驅動程式在 SampleCount 中收到 0 或大於 32，驅動程式一律會在 pNumQualityLevels 指向的變數中傳回 0。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 d3d10umddi.h (include D3d10umddi.h)

另請參閱

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb