Функция NdisClIncomingCallComplete (ndis.h)
NdisClIncomingCallComplete возвращает согласие или отказ клиента от предлагаемого входящего вызова, для которого ранее возвращен NDIS_STATUS_PENDING а функция протокола ProtocolClIncomingCall.
Синтаксис
void NdisClIncomingCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Параметры
[in] Status
Установлено значение NDIS_STATUS_SUCCESS, если клиент принимает предлагаемый вызов. В противном случае этот параметр можно задать для любого NDIS_STATUS_XXX, кроме NDIS_STATUS_PENDING, чтобы указать причину, определяемую клиентом, чтобы отклонить вызов.
[in] NdisVcHandle
Указывает дескриптор VC, созданный диспетчером вызовов для представления входящего вызова. Клиент получил этот дескриптор из состояния VC, указанного ProtocolVcContext передан в качестве входного параметра в его функция ProtocolClIncomingCall.
[in] CallParameters
Указатель на структуру типа CO_CALL_PARAMETERS, указав параметры вызова для входящего вызова.
Возвращаемое значение
Никакой
Замечания
Если функция ProtocolClIncomingCall клиента возвращает NDIS_STATUS_PENDING для предлагаемого вызова, входящего в определенную SAP, ранее зарегистрированную клиентом с NdisClRegisterSap, клиент впоследствии должен вызвать NdisClIncomingCallComplete, чтобы указать, принимает ли он или отклоняет предлагаемый вызов.
Прежде чем вызывать NdisClIncomingCallComplete, такой клиент может вести переговоры с диспетчером вызовов, вызвав NdisClModifyCallQoS один или несколько раз, пока оба драйвера не достигли соглашения о приемлемом качестве обслуживания для входящего звонка или клиент определяет, что он должен отклонить предлагаемый вызов, так как его попытки изменить QoS достигнут какой-либо предел, определенный клиентом, без получения соглашения.
Если клиент изменил параметры вызова, переданные в функцию ProtocolClIncomingCall, необходимо задать элемент Flags в структуре CO_CALL_PARAMETERS с CALL_PARAMETERS_CHANGED при передаче этих изменений в NdisClIncomingCallComplete. В зависимости от того, принимает ли диспетчер вызовов или отклоняет предложенные клиентом изменения параметров вызова, NDIS впоследствии вызывает либо клиент. функция ProtocolClCallConnected или ее функция ProtocolClIncomingCloseCall соответственно.
Вызов NdisClIncomingCallComplete вызывает NDIS для вызова CM функция ProtocolCmIncomingCallComplete. NDIS передает предоставленные клиентом параметры NdisClIncomingCallComplete в качестве входных параметров в ProtocolCmIncomingCallComplete.
Если клиент отклоняет предлагаемый вызов, задав status значение, отличное от NDIS_STATUS_SUCCESS, клиент должен учитывать недопустимый указатель CallParameters, как только его вызов NdisClIncomingCallComplete.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. NdisClIncomingCallComplete (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. NdisClIncomingCallComplete (NDIS 5.1)) в Windows XP. |
| целевая платформа | Настольный |
| заголовка | ndis.h (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | Irql_Protocol_Driver_Function(ndis) |