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.
Header: Declared in dsound.h.