IAudioAutoGainControl::GetEnabled method (devicetopology.h)
The GetEnabled method gets the current state (enabled or disabled) of the AGC.
Syntax
HRESULT GetEnabled(
[out] BOOL *pbEnabled
);
Parameters
[out] pbEnabled
Pointer to a BOOL variable into which the method writes the current AGC state. If the state is TRUE, AGC is enabled. If FALSE, AGC is disabled.
Return value
If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.
| Return code | Description |
|---|---|
|
Pointer pbEnabled is NULL. |
Remarks
A disabled AGC operates in pass-through mode. In this mode, the audio stream passes through the AGC without modification.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | devicetopology.h |