NdisMCmDispatchIncomingCallQoSChange-Makro (ndis.h)

Artikel
08/07/2023

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)