NdisMCmDispatchIncomingCallQoSChange-Makro (ndis.h)
NdisMCmDispatchIncomingCallQoSChange 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 NdisMCmDispatchIncomingCallQoSChange(
_H_,
_P_
);
Parameter
_H_
Gibt das Handle für den Nachweis an, für den die Änderung in QoS angefordert wird. Der MCM-Treiber hat dieses Handle entweder abgerufen, wenn er NdisMCmCreateVc aufgerufen hat, um diese Verbindung für einen eingehenden Aufruf einzurichten, oder als Eingabeparameter für seine ProtocolCoCreateVc-Funktion .
_P_
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 MCM-Treiber ruft NdisMCmDispatchIncomingCallQoSChange auf, um den Client zu benachrichtigen, dass er eine Anforderung zum Ändern der QoS für eine aktive Verbindung erhalten hat. Ein solcher MCM-Treiber unterstützt dynamische QoS-Änderungen bei aktiven Aufrufen. Hierbei handelt es sich um ein Feature wie QoS selbst, das vom Signalisierungsprotokoll abhängt.
Der MCM-Treiber sollte NdisMCmActivateVc aufrufen, wenn er Änderungen an den Aufrufparametern für eine aktive VC vornimmt.
Ein Aufruf von NdisMCmDispatchIncomingCallQoSChange 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 verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, können NdisMCmDispatchIncomingCallQoSChange aufrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCmDispatchIncomingCallQoSChange auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCM_Function(ndis) |