DVM_CONFIGURESTORAGE

The DVM_CONFIGURESTORAGE message requests a user-mode video capture driver to save or restore a video channel’s configuration parameters.

Parameters

dwDriverID: Video channel identifier. One of VIDEO_EXTERNALIN, VIDEO_IN, VIDEO_OUT, VIDEO_EXTERNALOUT. (For details, see Opening Video Channels.)
hDriver: Driver handle.
uMsg: DVM_CONFIGURESTORAGE
lParam1: Pointer to a client-specified unique string.
lParam2: Contains flags. The following flags are defined:

Flag	Definition
VIDEO_CONFIGURE_GET	The channel’s configuration parameters should be restored from a file.
VIDEO_CONFIGURE_SET	The channel’s configuration parameters should be saved in a file.

Return Value

The driver should return DV_ERR_OK if the operation succeeds. Otherwise, it should return one of the DV_ERR error codes defined in msvideo.h. Custom error codes are also allowed (see DVM_GETERRORTEXT).

Comments

A client sends the DVM_CONFIGURESTORAGE message by calling the driver’s DriverProc entry point, passing the specified parameter values. Applications can send this message by calling the videoConfigureStorage function, which is described in the Video for Windows Development Kit.

If the value contained in lParam2 is VIDEO_CONFIGURE_SET, the driver should store the specified channel’s current configuration parameters in a file. The file name should consist of, or be based on, the string pointed to by lParam1.

If the value contained in lParam2 is VIDEO_CONFIGURE_GET, the driver should read the specified channel’s saved configuration parameters from the saved file, and use them as the channel’s current settings. You can assume the client will specify the same lParam1 value for saving and restoring the parameters.