NdisCmRegisterSapComplete-Funktion (ndis.h)

Artikel
02/26/2024

NdisCmRegisterSapComplete gibt die letzte status der Clientanforderung zurück, für die der CM zuvor NDIS_STATUS_PENDING zurückgegeben hat, um eine SAP zu registrieren.

Syntax

void NdisCmRegisterSapComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisSapHandle,
  [in] NDIS_HANDLE CallMgrSapContext
);

Parameter

[in] Status

Gibt den endgültigen status der ursprünglichen Anforderung des Clients zur Registrierung der SAP an, entweder NDIS_STATUS_SUCCESS oder ein beliebiger cm-bestimmter NDIS_STATUS_XXX außer NDIS_STATUS_PENDING.

[in] NdisSapHandle

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 .

[in] CallMgrSapContext

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

Rückgabewert

Keine

Bemerkungen

Ein eigenständiger Anruf-Manager muss NdisCmRegisterSapComplete aufrufen, wenn seine ProtocolCmRegisterSap-Funktion NDIS_STATUS_PENDING zurückgegeben hat, als sie mit dem angegebenen NdisSapHandle aufgerufen wurde. Der Aufruf von NdisCmRegisterSapComplete bewirkt, dass NDIS die des Clients aufruft. ProtocolClRegisterSapComplete-Funktion .

Wenn der Anruf-Manager Status auf etwas anderes als NDIS_STATUS_SUCCESS festlegt, sollte er den NdisSapHandle als ungültig betrachten, sobald er NdisCmRegisterSapComplete aufruft. Nachdem eine SAP-Registrierung fehlschlägt, kann der CM den sapspezifischen Kontextbereich freigeben oder wiederverwenden, den er zugewiesen hat, wenn NdisCmRegisterSapComplete die Steuerung zurückgibt. NDIS gibt auch seinen Kontext für sap frei, wenn der Anruf-Manager die Registrierung fehlschlägt.

Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmRegisterSapComplete aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung der Anrufverwaltung bieten, rufen NdisMCmRegisterSapComplete an.

Anforderungen

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