Microsoft DirectX 8.0 (Visual Basic)

Direct3D8.CheckDeviceMultiSampleType

このデバイスでマルチサンプリング テクニックを利用できるかどうかを調べる。

object.CheckDeviceMultiSampleType( _ 
    Adapter As Long, _ 
    DeviceType As CONST_D3DDEVTYPE, _ 
    Format As CONST_D3DFORMAT, _ 
    Windowed As Long, _ 
    MultiSampleType As CONST_D3DMULTISAMPLE_TYPE) As Long

指定項目

object
Direct3D8 オブジェクトを表すオブジェクト式。
Adapter
照会するディスプレイ アダプタを示す序数。D3DADAPTER_DEFAULT は常にプライマリ ディスプレイ アダプタである。Adapter の値がシステムのディスプレイ アダプタの数以上の場合、このメソッドは FALSE (0) を返す
DeviceType
デバイス タイプを識別する CONST_D3DDEVTYPE 列挙のメンバ。
Format
CONST_D3DFORMAT 列挙のメンバ。サーフェスに対して要求するマルチサンプリング タイプのセットを指定する。「注意」を参照すること。
Windowed
ウィンドウ マルチサンプリングについて問い合わせるときは TRUE を指定し、フルスクリーン マルチサンプリングについて問い合わせるときは FALSE を指定する。
MultiSampleType
CONST_D3DMULTISAMPLE_TYPE 列挙のメンバ。検査するマルチサンプリング テクニックを指定する。

戻り値

デバイスが、指定されたマルチサンプリング メソッドを実行できる場合、このメソッドは D3D_OK を返す。

失敗した場合は、次のいずれかの値を返す。

D3DERR_INVALIDCALL
D3DERR_INVALIDDEVICE
D3DERR_NOTAVAILABLE

注意

このメソッドは、レンダリング ターゲットおよび深度ステンシル サーフェスの両方で使用するためのものである。これは、この 2 つ一緒に使用する場合、両方をマルチサンプリングして作成する必要があるからである。

次のコードは、CheckDeviceMultiSampleType を使って、デバイスが特定のマルチサンプリング メソッドをサポートするかどうかをテストする方法を示している。

Dim Device As Direct3DDevice8
Dim Caps As D3DCAPS8
Dim Caps2 As CONST_D3DDEVTYPE
Dim Mode As CONST_D3DFORMAT

If Device.CheckDeviceMultiSampleType(Caps.AdapterOrdinal, Caps2.DeviceType, _ 
                                     Mode.Format, False, D3DMULTISAMPLE_3_SAMPLES) Then
    ' D3DMULTISAMPLE_3_SAMPLES が、フルスクリーン モードで、
    ' 指定されたサーフェス フォーマットについて機能する場合の処理。
End If

エラー コード

このメソッドでは、Err.Number は設定されていない。