Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.ApplyStateBlock

既存のデバイス ステート ブロックをレンダリング デバイスに適用する。

object.ApplyStateBlock( _ 
    Token As Long)

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
Token
実行するデバイス ステート ブロック (Direct3DDevice8.EndStateBlock メソッドによって返されたデバイス ステート ブロック) のハンドル。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

Token パラメータが無効またはマクロが現在記録中であるとき、Err.NumberD3DERR_INVALIDCALL が設定される。

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

値 &hFFFFFFFF& は、無効なステート ブロック ハンドルである。

アプリケーションがほかのブロックを記録している間は、デバイス ステート ブロックを適用できない。

レンダリング デバイスのステートに影響するすべての処理同様、シーンのレンダリング時、つまり Direct3DDevice8.BeginScene メソッドを呼び出してから Direct3DDevice8.EndScene メソッドを呼び出す前に、ステート ブロックを適用することを勧める。

参照

Direct3DDevice8.BeginStateBlockDirect3DDevice8.EndStateBlockDirect3DDevice8.CaptureStateBlockDirect3DDevice8.CreateStateBlockDirect3DDevice8.DeleteStateBlock