NdisMCmRegisterSapComplete-Makro (ndis.h)

Artikel
02/29/2024

NdisMCmRegisterSapComplete gibt die letzte status der Anforderung eines Clients zurück, für die der MCM-Treiber verwendet wird.

Die ProtocolCmRegisterSap-Funktion hat zuvor NDIS_STATUS_PENDING zurückgegeben, um eine SAP-Datei zu registrieren.

Syntax

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

Parameter

_S_

Gibt den endgültigen status für die ursprüngliche Anforderung des Clients zum Registrieren der SAP an, entweder NDIS_STATUS_SUCCESS oder ein vom Aufrufer bestimmter NDIS_STATUS_XXXaußer NDIS_STATUS_PENDING.

_H_

Gibt das von NDIS bereitgestellte Handle für SAP an, wenn die Registrierung erfolgreich ist. Der Aufruf-Manager hat dieses Handle als Eingabeparameter für seine ProtocolCmRegisterSap-Funktion abgerufen.

_C_

Gibt das Handle für einen vom Aufrufer bereitgestellten residenten Kontextbereich an, in dem der MCM-Treiber den Status für diesen SAP verwaltet, wenn die Registrierung erfolgreich ist. Wenn dies der Fall ist, übergibt NDIS dieses Handle bei allen nachfolgenden Aufrufen dieses SAP an den MCM-Treiber zurück an den MCM-Treiber. Wenn Status auf etwas anderes als NDIS_STATUS_SUCCESS festgelegt ist, ignoriert NDIS diesen Parameter.

Rückgabewert

Keine

Bemerkungen

Ein MCM-Treiber muss NdisMCmRegisterSapComplete aufrufen, wenn seine ProtocolCmRegisterSap-Funktion NDIS_STATUS_PENDING zurückgegeben hat, als sie mit dem angegebenen NdisSapHandle aufgerufen wurde. Der Aufruf von NdisMCmRegisterSapComplete bewirkt, dass NDIS die des Clients aufruft. ProtocolClRegisterSapComplete-Funktion .

Wenn der MCM-Treiber Status auf etwas anderes als NDIS_STATUS_SUCCESS festlegt, sollte er die NdisSapHandle als ungültig betrachten, wenn NdisMCmRegisterSapComplete die Steuerung zurückgibt. Nachdem eine SAP-Registrierung fehlgeschlagen ist, kann der CM den sapspezifischen Kontextbereich freigeben oder wiederverwenden, sofern vorhanden, den er bereits zugewiesen hat. NDIS gibt auch den Kontext für sap frei, wenn der MCM-Treiber bei der Registrierung fehlschlägt.

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

Anforderungen

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