NdisMCmModifyCallQoSComplete-Makro (ndis.h)

Artikel
02/29/2024

NdisMCmModifyCallQoSComplete gibt den Abschluss der Clientanforderung an, für die der MCM-Treiber zuvor NDIS_STATUS_PENDING zurückgegeben hat, um die Dienstqualität für eine VC zu ändern.

Syntax

void NdisMCmModifyCallQoSComplete(
   _S_,
   _H_,
   _P_
);

Parameter

_S_

Gibt den endgültigen status der Anforderung des Clients an, die QoS für diese VC zu ändern, entweder NDIS_STATUS_SUCCESS oder ein vom Aufrufer ermittelter NDIS_STATUS_XXXaußer NDIS_STATUS_PENDING.

_H_

Gibt das Handle für die VC an, das aus dem pro VC-Zustand abgerufen wird, der vom An den MCM-Treiber übergebenen CallMgrVcContext festgelegt wurde. ProtocolCmModifyCallQoS-Funktion für diese Anforderung.

_P_

Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS angeben, dass eine QoS angegeben wird, die für den MCM-Treiber akzeptabel ist, wenn Status auf NDIS_STATUS_SUCCESS festgelegt ist.

Rückgabewert

Keine

Bemerkungen

Ein Aufruf von NdisMCmModifyCallQoSComplete bewirkt, dass NDIS den Client aufruft. ProtocolClModifyCallQoSComplete-Funktion .

Der MCM-Treiber sollte NdisMCmActivateVc aufrufen, wenn er Änderungen an den Aufrufparametern für eine aktive VC vornimmt.

Da der MCM-Treiber die vom Client bereitgestellten Aufrufparameter ändern kann, die in seine ProtocolCmModifyCallQoS-Funktion eingegeben wurden, bevor er NdisMCmModifyCallQoSComplete aufruft, untersucht die ProtocolClModifyCallQoSComplete-Funktion des Clients die QoS, um zu ermitteln, ob sie für den Client akzeptabel ist. ProtocolClModifyCallQoSComplete gibt einfach die Steuerung zurück, wenn der Client die angegebenen Aufrufparameter akzeptiert. Andernfalls reißt der Client den Aufruf ab.

Nur verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, können NdisMCmModifyCallQoSComplete aufrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCmModifyCallQoSComplete auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCmModifyCallQoSComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCmModifyCallQoSComplete (NDIS 5.1)) in Windows XP.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_MCM_Function(ndis)