ID3DXEffect::BeginPass メソッド

  • [アーティクル]

アクティブな手法内でパスを開始します。

構文

HRESULT BeginPass(
  [in] UINT Pass
);

パラメーター

Pass [in]

型: UINT

手法への 0 から始まる整数インデックス。

戻り値

種類: HRESULT

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

解説

アプリケーションは 、ID3DXEffect::BeginPass を呼び出して、効果システムに 1 つのアクティブ パス (1 つのアクティブな手法内) を設定します。 アプリケーションは 、ID3DXEffect::EndPass を呼び出してアクティブ パスの終了を通知します。 ID3DXEffect::BeginPass と ID3DXEffect::EndPass は、ID3DXEffect::Begin 呼び出しと ID3DXEffect::End 呼び出しの一致するペア内で、一致するペアで発生する必要があります。

アプリケーションが ID3DXEffect::BeginPass ID3DXEffect::EndPass/ 照合ペア内の Effect::Setx メソッドのいずれかを使用して効果の状態を変更する場合、アプリケーションは ID3DXEffect::CommitChanges を呼び出して、状態が変更されたデバイスの更新を設定する必要があります。 ID3DXEffect::BeginPass と ID3DXEffect::EndPass の一致ペア内で状態変更が発生しない場合は、ID3DXEffect::CommitChanges を呼び出す必要はありません。

要件

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

関連項目

ID3DXEffect