?/TD>
Microsoft DirectX 9.0

IDirectInputDevice8::EnumCreatedEffectObjects Method


Enumerates all the currently created effects for this device. Effects created by IDirectInputDevice8::CreateEffect are enumerated.

Syntax

HRESULT EnumCreatedEffectObjects(      

    LPDIENUMCREATEDEFFECTOBJECTSCALLBACK lpCallback,     LPVOID pvRef,     DWORD fl );

Parameters

lpCallback
Address of an application-defined callback function. Microsoft?DirectInput?provides the prototype function DIEnumCreatedEffectObjectsCallback.
pvRef
Reference data (context) for callback.
fl
No flags are currently defined. This parameter must be 0.

Return Value

If the method succeeds, the return value is DI_OK.

If the method fails, the return value can be one of the following error values:

DIERR_INVALIDPARAMAn invalid parameter was passed to the returning function, or the object was not in a state that permitted the function to be called. This value is equal to the E_INVALIDARG standard Component Object Model (COM) return value.
DIERR_NOTINITIALIZEDThe object has not been initialized.


Remarks

The results are unpredictable if you create or destroy an effect while an enumeration is in progress. However, the callback function can safely release the effect passed to it.



© 2002 Microsoft Corporation. All rights reserved.