Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The GetChannelCount method retrieves the number of channels in the stream format for the audio session.
Syntax
HRESULT GetChannelCount(
[out] UINT32 *pdwCount
);
Parameters
[out] pdwCount
Pointer to a UINT32 variable into which the method writes the channel count.
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 |
|---|---|
|
Parameter pdwCount is NULL. |
|
The audio endpoint device has been unplugged, or the audio hardware or associated hardware resources have been reconfigured, disabled, removed, or otherwise made unavailable for use. |
|
The Windows audio service is not running. |
Remarks
Call this method to get the number of channels in the audio session before calling any of the other methods in the IChannelAudioVolume interface.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | audioclient.h |