NdisClIncomingCallComplete-Funktion (ndis.h)
NdisClIncomingCallComplete gibt die Annahme oder Ablehnung eines angebotenen eingehenden Anrufs durch einen Client zurück, für den die ProtocolClIncomingCall-Funktion des Clients zuvor NDIS_STATUS_PENDING zurückgegeben hat.
Syntax
void NdisClIncomingCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parameter
[in] Status
Ist auf NDIS_STATUS_SUCCESS festgelegt, wenn der Client den angebotenen Anruf akzeptiert. Andernfalls kann dieser Parameter auf einen beliebigen NDIS_STATUS_XXX mit Ausnahme von NDIS_STATUS_PENDING festgelegt werden, um den vom Client festgelegten Grund für die Ablehnung des Aufrufs anzugeben.
[in] NdisVcHandle
Gibt das Handle für den Vc an, der vom Anruf-Manager erstellt wurde, um den eingehenden Anruf darzustellen. Der Client hat dieses Handle von ihm pro VC-Zustand abgerufen, der vom ProtocolVcContext als Eingabeparameter an seinen ProtocolClIncomingCall-Funktion .
[in] CallParameters
Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS, der die Aufrufparameter für den eingehenden Aufruf angibt.
Rückgabewert
Keine
Bemerkungen
Wenn die ProtocolClIncomingCall-Funktion eines Clients NDIS_STATUS_PENDING für einen angebotenen Anruf zurückgibt, der auf einem bestimmten SAP eingehen und zuvor vom Client mit NdisClRegisterSap registriert wurde, muss der Client anschließend NdisClIncomingCallComplete aufrufen, um anzugeben, ob er den angebotenen Anruf akzeptiert oder ablehnt.
Bevor er NdisClIncomingCallComplete aufruft, kann ein solcher Client mit dem Anrufmanager verhandeln, indem er NdisClModifyCallQoS ein oder mehrere Male aufruft, bis beide Treiber eine Vereinbarung über eine akzeptable Dienstqualität für den eingehenden Anruf erzielen oder der Client bestimmt, dass er den angebotenen Anruf ablehnen sollte, da seine Versuche, die QoS zu ändern, einen vom Client festgelegten Grenzwert erreichen, ohne zu einer Vereinbarung zu führen.
Wenn der Client die Aufrufparameter geändert hat, die an seine ProtocolClIncomingCall-Funktion übergeben wurden, muss er den Flags-Member in der CO_CALL_PARAMETERS-Struktur mit CALL_PARAMETERS_CHANGED festlegen, wenn er diese Änderungen an NdisClIncomingCallComplete übergibt. Abhängig davon, ob der Anrufmanager die vom Client vorgeschlagenen Änderungen an den Aufrufparametern akzeptiert oder ablehnt, ruft NDIS anschließend entweder die des Clients auf. ProtocolClCallConnected-Funktion oder ihre ProtocolClIncomingCloseCall-Funktion bzw.
Ein Aufruf von NdisClIncomingCallComplete bewirkt, dass NDIS den CM aufruft. ProtocolCmIncomingCallComplete-Funktion . NDIS übergibt die vom Client bereitgestellten Parameter von NdisClIncomingCallComplete als Eingabeparameter an ProtocolCmIncomingCallComplete.
Wenn ein Client einen angebotenen Aufruf ablehnt, indem er Status auf etwas anderes als NDIS_STATUS_SUCCESS festlegt, muss der Client den CallParameters-Zeiger als ungültig betrachten, sobald der Aufruf von NdisClIncomingCallComplete erfolgt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisClIncomingCallComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisClIncomingCallComplete (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |