NdisCmDispatchIncomingCallQoSChange-Funktion (ndis.h)
NdisCmDispatchIncomingCallQoSChange benachrichtigt einen Client, dass eine Anforderung zum Ändern der Dienstqualität für die aktive Verbindung dieses Clients über das Netzwerk empfangen wurde.
Syntax
void NdisCmDispatchIncomingCallQoSChange(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parameter
[in] NdisVcHandle
Gibt das Handle für den Nachweis an, für den die Änderung in QoS angefordert wird. Der Aufruf-Manager hat dieses Handle ursprünglich abgerufen, wenn er NdisCoCreateVc aufgerufen hat, um diese Verbindung für einen eingehenden Aufruf einzurichten, oder als Eingabeparameter für seine ProtocolCoCreateVc-Funktion .
[in] CallParameters
Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS , die die neue QoS angibt, die vom Client auf dem Remoteknoten für diese Verbindung angefordert wird.
Rückgabewert
Keine
Bemerkungen
Ein eigenständiger Anruf-Manager ruft NdisCmDispatchIncomingCallQoSChange auf, um den Client zu benachrichtigen, dass er eine Anforderung zum Ändern der QoS für eine aktive Verbindung erhalten hat. Ein solcher CM unterstützt dynamische QoS-Änderungen bei aktiven Aufrufen. Hierbei handelt es sich um ein Feature wie QoS selbst, das vom Signalisierungsprotokoll abhängt.
Wenn der CM selbst eine Anforderung für eine QoS-Änderung empfängt, übergibt der Aufruf-Manager entsprechend geänderte Aufrufparameter an NdisCmActivateVc, sodass der zugrunde liegende Miniporttreiber auch über die vorgeschlagene QoS-Änderung benachrichtigt wird. Wenn der zugrunde liegende Miniporttreiber die geänderten Aufrufparameter akzeptiert, ruft der CM dann NdisCmDispatchIncomingCallQoSChange auf.
Ein Aufruf von NdisCmDispatchIncomingCallQoSChange bewirkt, dass NDIS die ProtocolClIncomingQoSChange-Funktion des Clients aufruft . Der Client akzeptiert die vorgeschlagenen Änderungen an den Aufrufparametern für die Vc, indem er nichts tut, außer möglicherweise einen Zustand zu aktualisieren, den er über die QoS für die Vc verwaltet, und gibt die Steuerung zurück. Andernfalls lehnt der Client die vorgeschlagene QoS-Änderung ab, indem er den Aufruf abreißt.
Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmDispatchIncomingCallQoSChange aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bereitstellen, rufen stattdessen NdisMCmDispatchIncomingCallQoSChange an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_CallManager_Function(ndis) |