Метод ID3DXEffect:: Begin

Запускает активный метод.

Синтаксис

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

Параметры

ппассес [ заполняет]

Тип: uint*

Указатель на возвращаемое значение, указывающее количество проходов, необходимых для отрисовки текущего метода.

Флаги [ окне]

Тип: DWORD

Параметр DWORD, определяющий сохранение и восстановление состояния, измененного в результате действия. Значение по умолчанию 0 указывает, что ID3DXEffect:: Begin и ID3DXEffect:: end сохранит и восстановит все состояния, измененные этим действием (включая константы в пикселях и шейдере вершин). Допустимые флаги можно увидеть на странице Флаги сохранения и восстановления состояния влияния.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращается значение D3D _ ОК. В случае сбоя метода возвращаемое значение может быть одним из следующих: D3DERR _ инвалидкалл, D3DXERR _ INVALIDDATA.

Remarks

Приложение устанавливает один активный метод в системе эффектов, вызывая ID3DXEffect:: Begin. Система влияния отвечает, записывая все состояния конвейера, которые могут быть изменены методом в блоке состояния. Приложение сигнализирует об окончании приемки, вызвав ID3DXEffect:: end, который использует блок состояния для восстановления исходного состояния. Таким образом, система эффектов выполняет сохранение состояния, когда прием становится активным, и восстанавливает состояние при завершении метода. Если вы решили отключить эту функцию сохранения и восстановления, см. раздел D3DXFX _ донотсавесамплерстате.

В паре ID3DXEffect:: Begin и ID3DXEffect:: end приложение использует ID3DXEffect:: бегинпасс для установки активного прохода, ID3DXEffect:: CommitChanges , если после активации прохода возникли какие либо изменения состояния, и ID3DXEffect:: ендпасс , чтобы завершить активный проход.

Requirements (Требования)

Требование Значение
Заголовок
D3DX9Effect. h
Библиотека
D3dx9. lib

См. также

ID3DXEffect