Método ID3DXEffect::Begin

Inicia una técnica activa.

Sintaxis

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

Parámetros

pPasses [out]

Tipo: UINT*

Puntero a un valor devuelto que indica el número de pases necesarios para representar la técnica actual.

Marcas [in]

Tipo: DWORD

DWORD que determina si el estado modificado por un efecto se guarda y restaura. El valor predeterminado 0 especifica que ID3DXEffect::Begin e ID3DXEffect::End guardarán y restaurarán todo el estado modificado por el efecto (incluidas las constantes de sombreador de píxeles y vértices). Las marcas válidas se pueden ver en Effect State Save and Restore Flags ( Guardar y restaurar marcas).

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentarios

Una aplicación establece una técnica activa en el sistema de efectos llamando a ID3DXEffect::Begin. El sistema de efectos responde capturando todo el estado de canalización que la técnica puede cambiar en un bloque de estado. Una aplicación señala el final de una técnica llamando a ID3DXEffect::End, que usa el bloque de estado para restaurar el estado original. Por lo tanto, el sistema de efectos se encarga de guardar el estado cuando una técnica se activa y restaura el estado cuando finaliza una técnica. Si decide deshabilitar esta funcionalidad de guardado y restauración, consulte D3DXFX_DONOTSAVESAMPLERSTATE.

Dentro del par ID3DXEffect::Begin e ID3DXEffect::End , una aplicación usa ID3DXEffect::BeginPass para establecer el pase activo, ID3DXEffect::CommitChanges si se ha producido algún cambio de estado después de activar el paso y ID3DXEffect::EndPass para finalizar el pase activo.

Requisitos

Requisito	Value
Encabezado	D3DX9Effect.h
Biblioteca	D3dx9.lib

Consulte también

ID3DXEffect