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 an, für das die Änderung in QoS angefordert wird. Der Anrufmanager hat dieses Handle ursprünglich erhalten, wenn er NdisCoCreateVc- aufgerufen hat, um diese Verbindung für einen eingehenden Anruf oder als Eingabeparameter für seine ProtocolCoCreateVc--Funktion einzurichten.
[in] CallParameters
Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS, die den neuen QoS angibt, der vom Client auf dem Remoteknoten angefordert wird, für diese Verbindung.
Rückgabewert
Nichts
Bemerkungen
Ein eigenständiger Anrufmanager ruft NdisCmDispatchIncomingCallQoSChange auf, um den Client zu benachrichtigen, dass er eine Anforderung zum Ändern des QoS für eine aktive Verbindung erhalten hat. Ein solcher CM unterstützt dynamische QoS-Änderungen bei aktiven Aufrufen. Dabei handelt es sich um ein Feature wie QoS selbst, das vom Signalprotokoll abhängt.
Wenn der CM selbst eine Anforderung für eine QoS-Änderung empfängt, übergibt der Anrufmanager entsprechend geänderte Anrufparameter 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 NdisCmDispatchIncomingCallQoSChangeauf.
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 nichts ausgeführt wird, es sei denn, er aktualisiert möglicherweise einen Zustand, den er über den QoS für die VC verwaltet, und gibt das Steuerelement zurück. Andernfalls lehnt der Client die vorgeschlagene QoS-Änderung ab, indem er den Aufruf abreißt.
Nur eigenständige Anrufmanager, die sich selbst bei NDIS als Protokolltreiber registrieren, können NdisCmDispatchIncomingCallQoSChangeaufrufen. Verbindungsorientierte Miniporttreiber, die einen integrierten Anrufverwaltungssupport-Anruf NdisMCmDispatchIncomingCallQoSChange bereitstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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 |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_CallManager_Function(ndis) |