Customizing Setup With the DirectSetup Callback Function

DirectSetup for DirectX 5 allows developers to specify a setup callback function. In the DirectSetup documentation, the callback function is referred to as DirectXSetupCallbackFunction. However, the actual name of the callback function is supplied by the application setup program.

If it is provided, DirectXSetupCallbackFunction is called once for each DirectX component and device driver that can be upgraded by the DirectXSetup function. Note that the callback function is completely optional. It does not have to be provided.

If a callback function is not provided by the setup program, DirectXSetup will display status and error information by calling the MessageBox function. If a callback is provided, the information that would be used by DirectXSetup to display the status with MessageBox is passed as parameters to the DirectXSetupCallbackFunction callback function. The callback function can use this information to display a status or error message using MessageBox. It can also implement a custom user interface to display the status or error message.

The following topics help you customize your setup:

• Uses of the DirectSetup Callback Function
• Providing a Callback Function to DirectSetup
• Interpreting DirectSetup Flags in the Callback Function
• Overriding DirectSetup Flags in the Callback Function
• An Example Callback Function