NdisMCoActivateVcComplete-Funktion (ndis.h)
NdisMCoActivateVcComplete benachrichtigt NDIS und den Anrufmanager, dass der Miniporttreiber die Verarbeitung einer CM-initiierten Activate-VC-Anforderung abgeschlossen hat, für die der Miniporttreiber zuvor NDIS_STATUS_PENDING zurückgegeben hat.
Syntax
void NdisMCoActivateVcComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parameter
[in] Status
Gibt den endgültigen Status des Activate-VC-Vorgangs an, der mit Ausnahme von NDIS_STATUS_PENDING NDIS_STATUS_SUCCESS oder einem beliebigen NDIS_STATUS_ XXX sein kann.
[in] NdisVcHandle
Gibt den Handle an, der die VC identifiziert. Der Aufrufer hat dieses Handle aus dem status pro VC abgerufen, der vom MiniportVcContext als Eingabeparameter an seine MiniportCoActivateVc Funktion.
[in] CallParameters
Zeigen Sie auf eine Struktur vom Typ CO_CALL_PARAMETERS, die vom Anruf-Manager bereitgestellt wird, und geben Sie die Anruf- und Medienparameter für die VC-Aktivierung an.
Rückgabewert
Nichts
Bemerkungen
Ein verbindungsorientierter Miniporttreiber muss NdisMCoActivateVcComplete- aufrufen, wenn seine MiniportCoActivateVc--Funktion zuvor NDIS_STATUS_PENDING als Reaktion auf eine Anforderung zum Aktivieren oder Reaktivieren der vc identifiziert durch den angegebenen NdisVcHandle zurückgegeben wurde. Der Anruf-Manager, der die VC-Aktivierung mit einem Aufruf von NdisCmActivateVcinitiiert hat, kann NDIS oder dessen Client nicht benachrichtigen, ob Übertragungen auf dem VC mithilfe der bereitgestellten Anrufparameter erfolgen können, bis der Miniporttreiber NdisMCoActivateVcCompleteaufruft.
Wenn der Miniporttreiber die cm-bereitgestellten Aufrufparameter inakzeptabel findet, schlägt die VC-Aktivierung fehl, wenn sie NdisMCoActivateVcCompleteaufruft. Wenn die anfängliche Aktivierung einer VC fehlschlägt, kann das Protokoll, das den VC erstellt hat, ihn abreißen lassen. Wenn der Miniporttreiber eine Anforderung zum Reaktivieren eines etablierten VC mit neuen Aufrufparametern nicht erfüllt, muss er die ursprünglichen Aufrufparameter wiederherstellen, die für diese VC festgelegt wurden. Je nach Art des Netzwerkmediums kann ein Miniporttreiber die Medienparameter ändern, wenn die Roundup- und/oder Rounddown-Flags festgelegt werden, bevor NdisMCoActivateVcCompleteaufgerufen wird.
Ein Aufruf von NdisMCoActivateVcComplete bewirkt, dass NDIS die ProtocolCmActivateVcComplete Funktion des Anruf-Managers, der ursprünglich die VC-Aktivierung angefordert hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCoActivateVcComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCoActivateVcComplete (NDIS 5.1)) in Windows XP. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCO_Function(ndis) |