NdisMCoActivateVcComplete-Funktion (ndis.h)
NdisMCoActivateVcComplete benachrichtigt NDIS und den Anruf-Manager, 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 die endgültige status des activate-VC-Vorgangs an, der NDIS_STATUS_SUCCESS oder ein beliebiger NDIS_STATUS_ XXX außer NDIS_STATUS_PENDING sein kann.
[in] NdisVcHandle
Gibt das Handle an, das den Nachweis identifiziert. Der Aufrufer hat dieses Handle aus seinem Pro-VC-Zustand abgerufen, der vom MiniportVcContext festgelegt wurde, der als Eingabeparameter an seine übergeben wurde. MiniportCoActivateVc-Funktion .
[in] CallParameters
Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS, die vom Aufruf-Manager bereitgestellt wird und die Aufruf- und Medienparameter für die Aktivierung des Nachweises angibt.
Rückgabewert
Keine
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 vom angegebenen NdisVcHandle identifizierten Vc zurückgegeben hat. Der Anruf-Manager, der die Vc-Aktivierung mit einem Aufruf von NdisCmActivateVc initiiert hat, kann NDIS oder seinen Client nicht darüber benachrichtigen, ob Übertragungen auf dem Nachweis mithilfe der angegebenen Anrufparameter durchgeführt werden können, bis der Miniporttreiber NdisMCoActivateVcComplete aufruft.
Wenn der Miniporttreiber die von CM bereitgestellten Aufrufparameter für nicht akzeptabel hält, schlägt die VC-Aktivierung fehl, wenn er NdisMCoActivateVcComplete aufruft. Wenn die anfängliche Aktivierung eines Nachweises nicht ausgeführt wird, kann dies dazu führen, dass das Protokoll, das den Nachweis erstellt hat, ihn abreißt. Wenn der Miniporttreiber eine Anforderung zum Reaktivieren einer eingerichteten Vc mit neuen Aufrufparametern fehlschlägt, muss er die ursprünglichen Aufrufparameter wiederherstellen, die für diesen Vc eingerichtet wurden. Abhängig von der Art des Netzwerkmediums kann ein Miniporttreiber die Medienparameter ändern, wenn die Rundungs- und/oder Round-Down-Flags festgelegt sind, bevor NdisMCoActivateVcComplete aufgerufen wird.
Ein Aufruf von NdisMCoActivateVcComplete bewirkt, dass NDIS den aufruft. ProtocolCmActivateVcComplete-Funktion des Aufruf-Managers, der ursprünglich die Aktivierung des Nachweises angefordert hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (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 |
| Kopfzeile | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCO_Function(ndis) |