ID3DXEffect::Begin メソッド

  • [アーティクル]

アクティブな手法を開始します。

構文

HRESULT Begin(
  [out] UINT  *pPasses,
  [in]  DWORD Flags
);

パラメーター

pPasses [out]

型: UINT*

現在の手法をレンダリングするために必要なパスの数を示す、返される値へのポインター。

Flags [in]

種類: DWORD

効果によって変更された状態を保存して復元するかどうかを決定する DWORD。 既定値 0 は 、ID3DXEffect::Begin と ID3DXEffect::End が効果によって変更されたすべての状態 (ピクセルシェーダー定数と頂点シェーダー定数を含む) を保存して復元することを指定します。 有効なフラグは、 効果状態の保存および復元フラグで確認できます。

戻り値

種類: HRESULT

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

注釈

アプリケーションは 、ID3DXEffect::Begin を呼び出して、効果システムにアクティブな手法を 1 つ設定します。 エフェクト システムは、状態ブロック内の手法によって変更できるすべてのパイプライン状態をキャプチャすることによって応答します。 アプリケーションは、状態ブロックを使用して元の状態を復元する ID3DXEffect::End を呼び出して、手法の終了を通知します。 したがって、効果システムは、技術がアクティブになったときの保存状態と、技術の終了時の復元状態を処理します。 この保存と復元の機能を無効にする場合は、「 D3DXFX_DONOTSAVESAMPLERSTATE」を参照してください。

ID3DXEffect::Begin と ID3DXEffect::End ペア内で、アプリケーションは ID3DXEffect::BeginPass を使用してアクティブ パスを設定し、パスがアクティブ化された後に状態が変更された場合は ID3DXEffect::CommitChanges、アクティブ パスを終了するには ID3DXEffect::EndPass を使用します。

要件

要件 値
ヘッダー
D3DX9Effect.h
ライブラリ
D3dx9.lib

こちらもご覧ください

ID3DXEffect