OnExecute method

Called by the base class to cause a transform to produce its output.

Syntax

HRESULT retVal = object.OnExecute(pRequestID, pClipBnds, pPlacement);

Parameters

• pRequestID [in]
  Type: const GUID

  Pointer to the ID passed into the IDXTransform::Execute method by the caller. This ID should be passed to the task manager if CDXBaseNTo1::OnExecute schedules any asynchronous work through the task manager. Otherwise, this parameter should be ignored.

• pClipBnds [in]
  Type: const DXBNDS

  Pointer to the portion of the transform output space that should be rendered. If NULL, the entire output space is rendered. If a transform can't produce the specified region of the result, the transform should mask off the DXTMF_BOUNDS_SUPPORTED flag from the m_dwMiscFlags data member in the Active Template Library (ATL) CComObjectRootEx::FinalConstruct constructor method. Image transforms must be able to render regions of their output.

• pPlacement [in]
  Type: const DXVEC

  Pointer to the position to place the result in the output coordinate space. If the transform does not support this capability, it should mask off the DXTMF_PLACEMENT_SUPPORTED flag from the m_dwMiscFlags data member in the FinalConstruct constructor method.

Remarks

Typically, This function can be called for 2-D transforms if the m_ulMaxImageBands data member is set to zero in the FinalConstruct constructor method.

See also

IDXTaskManager::ScheduleTasks