Microsoft DirectX 8.0

IGraphConfigCallback Interface

The IGraphConfigCallback interface contains the callback method passed to IGraphConfig::Reconfigure. The caller (an application or filter) implements this interface. For more information, see IGraphConfig.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterfaceRetrieves pointers to supported interfaces.
AddRefIncrements the reference count.
ReleaseDecrements the reference count.
IGraphConfigCallback methodsDescription
ReconfigureCallback method passed to IGraphConfig::Reconfigure.

IGraphConfigCallback::Reconfigure

IGraphConfigCallback Interface

Callback method passed to IGraphConfig::Reconfigure.

Syntax

HRESULT Reconfigure(
    PVOID pvContext,
    DWORD dwFlags
);

Parameters

pvContext
Value passed in the IGraphConfig::Reconfigure method's pvContext parameter.
dwFlags
Value passed in the IGraphConfig::Reconfigure method's dwFlags parameter.

Return Value

Returns S_OK if successful. Otherwise, returns an HRESULT value indicating the cause of the error.

Remarks

If your application or filter calls IGraphConfig::Reconfigure, you must implement this method and pass it as a callback. The IGraphConfig::Reconfigure method obtains a lock on the filter graph before calling your Reconfigure method. Your method then handles all the other details of dynamic graph building.

If this method succeeds, IGraphConfig::Reconfigure tries to put all the filters in the graph back into a running state. If the method fails, IGraphConfig::Reconfigure returns whatever error code this method returned.

This method allows for specialized graph rebuilding. For a more straightforward approach to dynamic graph building, see IGraphConfig::Reconnect.