IDirect3DDevice9::BeginStateBlock

デバイス ステート ブロックの記録を開始することを Direct3D に通知します。

HRESULT 
BeginStateBlock(
);

パラメータ

なし。

戻り値

メソッドが成功した場合は、D3D_OK を返します。失敗した場合は、次の戻り値のいずれかを返します。D3DERR_INVALIDCALL、E_OUTOFMEMORY

解説　

このメソッドを呼び出す前に、IDirect3DDevice9::ValidateDevice メソッドを呼び出して記録されているすべてのステートが有効であることを確認できます。

IDirect3DDevice9::BeginStateBlock を呼び出した後、および IDirect3DDevice9::EndStateBlock を呼び出す前に次のメソッドをステート ブロックに記録できます。

• IDirect3DDevice9::LightEnable
• IDirect3DDevice9::SetClipPlane
• IDirect3DDevice9::SetCurrentTexturePalette
• IDirect3DDevice9::SetFVF
• IDirect3DDevice9::SetIndices
• IDirect3DDevice9::SetLight
• IDirect3DDevice9::SetMaterial
• IDirect3DDevice9::SetNPatchMode
• IDirect3DDevice9::SetPixelShader
• IDirect3DDevice9::SetPixelShaderConstantB
• IDirect3DDevice9::SetPixelShaderConstantF
• IDirect3DDevice9::SetPixelShaderConstantI
• IDirect3DDevice9::SetRenderState
• IDirect3DDevice9::SetSamplerState
• IDirect3DDevice9::SetScissorRect
• IDirect3DDevice9::SetStreamSource
• IDirect3DDevice9::SetStreamSourceFreq
• IDirect3DDevice9::SetTexture
• IDirect3DDevice9::SetTextureStageState
• IDirect3DDevice9::SetTransform
• IDirect3DDevice9::SetViewport
• IDirect3DDevice9::SetVertexDeclaration
• IDirect3DDevice9::SetVertexShader
• IDirect3DDevice9::SetVertexShaderConstantB
• IDirect3DDevice9::SetVertexShaderConstantF
• IDirect3DDevice9::SetVertexShaderConstantI

ステート ブロックでのステートの変化の順序は保証されません。同じステートをステート ブロックで複数回指定した場合、最後の値のみが使用されます。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容

関連項目

IDirect3DDevice9::EndStateBlock, IDirect3DDevice9::CreateStateBlock