Platform SDK: DirectX |
IDirect3DDevice7::Clear メソッドは、ビューポート (またはビューポート内の矩形セット) を特定の RGBA 色にクリア、深度バッファをクリア、およびステンシル バッファを削除する。このメソッドは、従来の IDirect3DViewport3 インターフェイスが公開したクリアメソッドに代わって使用される。
HRESULT Clear( DWORD dwCount, LPD3DRECT lpRects, DWORD dwFlags, DWORD dwColor, D3DVALUE dvZ, DWORD dwStencil );
成功すれば D3D_OK を返す。
失敗すれば、次のいずれかの値を返す。
D3DERR_STENCILBUFFER_NOTPRESENT |
D3DERR_VIEWPORTHASNODEVICE |
D3DERR_ZBUFFER_NOTPRESENT |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
このメソッドは IDirect3DDevice7 インターフェイスと共に導入された。
このメソッドは、レンダリング ターゲットに深度バッファがアタッチされていないときに D3DCLEAR_ZBUFFER または D3DCLEAR_STENCIL フラグを指定すると失敗する。同様に、深度バッファ フォーマットにステンシル バッファ情報が含まれていない場合、D3DCLEAR_STENCIL フラグを指定すると、このメソッドは失敗する。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
バージョン :DirectX 7.0 が必要。
ヘッダー : d3d.h で宣言。