ICallFrame interface

Enables manipulation of call frames such as stack frames. The call frame is the body of information that a procedure must save to allow it to properly return to its caller. A call frame may exist on the stack or in registers. A stack frame maintains its caller's context information on the stack.

An instance of the ICallFrame interface can perform various transformations on a call frame. The call can be marshaled or persisted. The instance of this interface is bound and has an associated method number.

When to implement

You do not need to implement this interface. However, to receive an instance of ICallFrame, the client must create an interceptor. To create an interceptor for a given interface or to find its unmarshaler, instantiate the proxy-stub class for the object using the CoCreateInstance function and set the appropriate IID for the interface. Then query for the ICallInterceptor or ICallUnmarshal interface. Calling ICallInterceptor creates an instance of ICallFrame object. When the user calls ICallUnmarshal an instance of an unmarshaled class is created for the specified interface and method number.

When to use

You can use ICallFrame for marshaling, call frame persistence, and interface-pointer swizzling. For example, you can construct a generic implementation of interfaced proxies and stubs that operate by dispatching operations to an instance of ICallFrame. The interface proxy or stub would contain generic logic to drive the marshalling process and therefore use the services from ICallFrame to carry out the interface-specific work.

Members

The ICallFrame interface inherits from the IUnknown interface. ICallFrame also has these types of members:

• Methods

Methods

The ICallFrame interface has these methods.

Requirements