Microsoft DirectX 8.0 (C++)

IDirectSoundCaptureBuffer8::GetFXStatus

Retrieves the status of effects for the capture buffer.

HRESULT GetFXStatus(
  DWORD dwFXCount, 
  LPDWORD pdwFXStatus
);

Parameters

dwFXCount
Value that specifies the number of elements in the pdwFXStatus array.
pdwFXStatus
Address of an array of DWORD variables that receive the status of each effect. This should contain the same number of elements as the array passed in the lpDSCFXDesc parameter of IDirectSoundCapture8::CreateCaptureBuffer.For each effect, one of the following flags is returned.
DSCFXR_LOCHARDWARE
Effect is instantiated in hardware.
DSCFXR_LOCSOFTWARE
Effect is instantiated in software.
DSCFXR_UNALLOCATED
Effect has not yet been assigned to hardware nor software.
DSCFXR_FAILED
No effect was created because resources weren't available.
DSCFXR_UNKNOWN
No effect was created because the effect isn't registered on the system.

Return Values

If the method succeeds, the return value is DS_OK.

If the method fails, the return value may be DSERR_INVALIDPARAM.

Requirements

  Header: Declared in dsound.h.