共用方式為


IDirect3D9::CheckDeviceMultiSampleType 方法 (d3d9.h)

判斷此裝置上是否提供多重取樣技術。

語法

HRESULT CheckDeviceMultiSampleType(
  [in]  UINT                Adapter,
  [in]  D3DDEVTYPE          DeviceType,
  [in]  D3DFORMAT           SurfaceFormat,
  [in]  BOOL                Windowed,
  [in]  D3DMULTISAMPLE_TYPE MultiSampleType,
  [out] DWORD               *pQualityLevels
);

參數

[in] Adapter

類型: UINT

序數表示要查詢的顯示配接器。 D3DADAPTER_DEFAULT一律是主要顯示介面卡。 當這個值等於或超過系統中的顯示介面卡數目時,這個方法會傳回 FALSE 。 請參閱<備註>。

[in] DeviceType

類型: D3DDEVTYPE

識別裝置類型之 D3DDEVTYPE 列舉型別的成員。

[in] SurfaceFormat

類型: D3DFORMAT

D3DFORMAT列舉型別的成員,指定要多重取樣之表面的格式。 如需詳細資訊,請參閱<備註>。

[in] Windowed

類型: BOOL

bool 值。 指定 TRUE 以查詢視窗式多重取樣,並指定 FALSE 來查詢全螢幕多重取樣。

[in] MultiSampleType

類型: D3DMULTISAMPLE_TYPE

D3DMULTISAMPLE_TYPE列舉型別的成員,識別要測試的多取樣技術。

[out] pQualityLevels

類型: DWORD*

pQualityLevels 會傳回指定樣本類型可用的裝置特定取樣變化數目。 例如,如果傳回的值是 3,則在建立具有指定樣本計數的資源時,可以使用品質等級 0、1 和 2。 這些品質等級的意義是由裝置製造商所定義,無法透過 D3D 查詢。 例如,對於固定樣本計數的特定裝置不同品質層級,可能會參考範例位置的不同空間配置,或解析的不同方法。 如果不需要傳回品質等級,這可以是 Null

傳回值

類型: HRESULT

如果裝置可以執行指定的多重取樣方法,這個方法會傳回D3D_OK。 如果 Adapter 或 MultiSampleType 參數無效,則會傳回D3DERR_INVALIDCALL。 如果此裝置不支援查詢的多重取樣技術,這個方法會傳回D3DERR_NOTAVAILABLE。 如果 DeviceType 不適用於此配接器,則會傳回D3DERR_INVALIDDEVICE。

備註

此方法適用于轉譯目標和深度樣板表面,因為如果您想要同時使用兩個表面,則必須建立兩個表面多重取樣。

下列程式碼片段示範如何使用 CheckDeviceMultiSampleType 來測試支援特定多重取樣方法的裝置。


if( SUCCEEDED(pD3D->CheckDeviceMultiSampleType( pCaps->AdapterOrdinal, 
                                pCaps->DeviceType, BackBufferFormat, 
                                FALSE, D3DMULTISAMPLE_3_SAMPLES, NULL ) ) &&
         SUCCEEDED(pD3D->CheckDeviceMultiSampleType( pCaps->AdapterOrdinal, 
                                pCaps->DeviceType, DepthBufferFormat, 
                                FALSE, D3DMULTISAMPLE_3_SAMPLES, NULL ) ) )
    return S_OK;

如果裝置支援具有表面格式的全螢幕D3DMULTISAMPLE_3_SAMPLES多重取樣方法,上述程式碼會傳回S_OK。

如需使用和設定多重取樣類型和品質等級的其他資訊,請參閱 D3DMULTISAMPLE_TYPE 中的備註。

需求

   
目標平台 Windows
標頭 d3d9.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3D9