Microsoft DirectX 8.0 |
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.
IUnknown methods Description QueryInterface Retrieves pointers to supported interfaces. AddRef Increments the reference count. Release Decrements the reference count. IGraphConfigCallback methods Description Reconfigure Callback method passed to IGraphConfig::Reconfigure.
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.