CDXBaseNTo1::OnExecute Method

This topic documents a feature of Visual Filters and Transitions, which is deprecated as of Windows Internet Explorer 9 and obsolete as of Internet Explorer 10.

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

Syntax


virtual HRESULT OnExecute(
    const GUID *pRequestID,
    const DXBNDS *pClipBnds,
    const DXVEC *pPlacement
) = 0;

Parameters

pRequestID
[in] 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] 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]  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.

Return Value

Returns S_OK or an implementation-dependent error code.

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

Community Additions

ADD
Show:
© 2014 Microsoft