Saves information about one or more force-feedback effects to a file that can be read by using IDirectInputDevice8::EnumEffectsInFile. This method is chiefly of interest to those wanting to write their own force-authoring applications.
HRESULT WriteEffectToFile( LPCSTR lpszFileName, DWORD dwEntries, LPCDIFILEEFFECT rgDiFileEft, DWORD dwFlags )
- Name of the RIFF file.
- Number of structures in the rgDiFileEft array.
- Array of DIFILEEFFECT structures.
Flags which control how the effect should be written. This can be DIFEF_DEFAULT (= 0) or the following value:
- Includes effects that are not defined by DirectInput. If this flag is not specified, only effects with GUIDs defined in Dinput.h, such as GUID_ConstantForce, are written.
If the method succeeds, it returns DI_OK. If it fails, the return value can be DIERR_INVALIDPARAM.