BthAGNetworkGetCallState
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function is called by the Audio Gateway (AG) service to retrieve the current state of the network.
Syntax
DWORD BthAGNetworkGetCallState ( PDWORD pdwFlags);
Parameters
pdwFlags[out]
Points to the received network flag. The following table shows the possible flag values.Flag options Description NETWORK_FLAGS_STATE_ACTIVE (0x01)
Indicates an active call.
NETWORK_FLAGS_STATE_HOLD (0x02)
Indicates a call that is on hold.
NETWORK_FLAGS_STATE_OFFERING (0x04)
Indicates an incoming call.
NETWORK_FLAGS_STATE_OUTGOING (0x08)
Indicates an outgoing call.
Return Value
If the function call succeeds, the return value is ERROR_SUCCESS. Any other value indicates a failure.
Remarks
BthAGNetworkGetCallState returns synchronously.
If the function call fails, call the BthAGOnNetworkEvent function. The following table shows the parameter values to pass.
| Parameter | Value |
|---|---|
dwEvent |
NETWORK_EVENT_FAILED |
pszParam |
Pointer to the NetworkCallFailedInfo structure. |
Requirements
| Header | btagpub.h |
| Library | Btagsvc_network.lib |
| Windows Embedded CE | Windows CE 5.0 and later |