NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS-Struktur (ndis.h)

Artikel
08/07/2023

Die NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS-Struktur gibt Die CoNDIS-Aufruf-Manager-ProtokollXxx-Funktionen für den Treiber an, der diese Struktur an die NdisSetOptionalHandlers-Funktion .

Syntax

typedef struct _NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS {
  NDIS_OBJECT_HEADER                  Header;
  ULONG                               Reserved;
  CO_CREATE_VC_HANDLER                CmCreateVcHandler;
  CO_DELETE_VC_HANDLER                CmDeleteVcHandler;
  CM_OPEN_AF_HANDLER                  CmOpenAfHandler;
  CM_CLOSE_AF_HANDLER                 CmCloseAfHandler;
  CM_REG_SAP_HANDLER                  CmRegisterSapHandler;
  CM_DEREG_SAP_HANDLER                CmDeregisterSapHandler;
  CM_MAKE_CALL_HANDLER                CmMakeCallHandler;
  CM_CLOSE_CALL_HANDLER               CmCloseCallHandler;
  CM_INCOMING_CALL_COMPLETE_HANDLER   CmIncomingCallCompleteHandler;
  CM_ADD_PARTY_HANDLER                CmAddPartyHandler;
  CM_DROP_PARTY_HANDLER               CmDropPartyHandler;
  CM_ACTIVATE_VC_COMPLETE_HANDLER     CmActivateVcCompleteHandler;
  CM_DEACTIVATE_VC_COMPLETE_HANDLER   CmDeactivateVcCompleteHandler;
  CM_MODIFY_CALL_QOS_HANDLER          CmModifyCallQoSHandler;
  CO_OID_REQUEST_HANDLER              CmOidRequestHandler;
  CO_OID_REQUEST_COMPLETE_HANDLER     CmOidRequestCompleteHandler;
  CM_NOTIFY_CLOSE_AF_COMPLETE_HANDLER CmNotifyCloseAfCompleteHandler;
} NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS, *PNDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die CoNDIS-Eigenschaftenstruktur des Aufrufmanagers (NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS). Legen Sie den Typmember der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_CO_CALL_MANAGER_OPTIONAL_HANDLERS, den Revisionsmember auf NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS_REVISION_1 und den Size-Member auf NDIS_SIZEOF_CO_CALL_MANAGER_OPTIONAL_HANDLERS_REVISION_1 fest.

Reserved

Reserviert für NDIS.

CmCreateVcHandler

Der Einstiegspunkt der ProtocolCoCreateVc-Funktion des Aufrufers.

CmDeleteVcHandler

Der Einstiegspunkt der ProtocolCoDeleteVc-Funktion des Aufrufers.

CmOpenAfHandler

Der Einstiegspunkt der ProtocolCmOpenAf-Funktion des Aufrufers.

CmCloseAfHandler

Der Einstiegspunkt der ProtocolCmCloseAf-Funktion des Aufrufers.

CmRegisterSapHandler

Der Einstiegspunkt des Aufrufers ProtocolCmRegisterSap-Funktion .

CmDeregisterSapHandler

Der Einstiegspunkt des Aufrufers ProtocolCmDeregisterSap-Funktion .

CmMakeCallHandler

Der Einstiegspunkt der ProtocolCmMakeCall-Funktion des Aufrufers.

CmCloseCallHandler

Der Einstiegspunkt des Aufrufers ProtocolCmCloseCall-Funktion .

CmIncomingCallCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolCmIncomingCallComplete-Funktion .

CmAddPartyHandler

Der Einstiegspunkt der ProtocolCmAddParty-Funktion des Aufrufers.

CmDropPartyHandler

Der Einstiegspunkt des Aufrufers ProtocolCmDropParty-Funktion .

CmActivateVcCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolCmActivateVcComplete-Funktion .

CmDeactivateVcCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolCmDeactivateVcComplete-Funktion .

CmModifyCallQoSHandler

Der Einstiegspunkt des Aufrufers ProtocolCmModifyCallQoS-Funktion .

CmOidRequestHandler

Der Einstiegspunkt des Aufrufers ProtocolCoOidRequest-Funktion .

CmOidRequestCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolCoOidRequestComplete-Funktion .

CmNotifyCloseAfCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolCmNotifyCloseAfComplete-Funktion .

Hinweise

Um Einstiegspunkte als CoNDIS-Anruf-Manager anzugeben, initialisiert ein Protokolltreiber oder Miniport-Anruf-Manager (MCM) eine NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS-Struktur und übergibt sie an die NdisSetOptionalHandlers-Funktion .

Eigenständige Aufruf-Manager-Einschränkungen

Ein eigenständiger Aufruf-Manager ruft NdisSetOptionalHandlers über die ProtocolSetOptions-Funktion auf. Der Aufruf-Manager muss jeden Einstiegspunkt in der NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS-Struktur auf eine vom Treiber bereitgestellte ProtocolXxx-Funktion festlegen, wenn er NdisSetOptionalHandlers aufruft, auch wenn der Anruf-Manager keine eingehenden Anrufe, ausgehenden Anrufe oder Point-to-Multipoint-Verbindungen unterstützt. Für jede Teilmenge verbindungsorientierter Funktionen, die ein solcher Aufruf-Manager nicht unterstützt, sollten seine Platzhalterfunktionen ProtocolXxx einfach NDIS_STATUS_NOT_SUPPORTED zurückgeben.

Nachdem ein eigenständiger Anrufmanager die NdisCmRegisterAddressFamilyEx-Funktion erfolgreich, NDIS ignoriert jeden Einstiegspunkt, den der Aufruf-Manager zuvor für die ProtocolOidRequestComplete-Funktion des NDIS_PROTOCOL_DRIVER_CHARACTERISTICS Struktur, die an den übergeben wurde NdisRegisterProtocolDriver-Funktion .

MCM-Einschränkungen

Ein MCM ruft die NdisSetOptionalHandlers-Funktion aus der MiniportSetOptions-Funktion auf. Der MCM muss jedes CmXxx-Element in der NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS-Struktur auf eine von MCM bereitgestellte ProtocolXxx-Funktion festlegen, auch wenn der MCM keine eingehenden Aufrufe, ausgehenden Anrufe oder Point-to-Multipoint-Verbindungen unterstützt. Für jede Teilmenge verbindungsorientierter Funktionen, die ein solcher MCM-Treiber nicht unterstützt, sollten seine ProtocolXxx-Funktionen einfach NDIS_STATUS_NOT_SUPPORTED zurückgeben. Beispielsweise ruft NDIS nie den registrierten MCM-Treiber auf. ProtocolCmActivateVcComplete oder ProtocolCmDeactivateVcComplete-Funktion , sodass diese Funktionen NDIS_STATUS_NOT_SUPPORTED zurückgeben können, aber über Einstiegspunkte in der NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS-Struktur verfügen müssen.

Ein MCM-Treiber muss Einstiegspunkte für die Funktionen ProtocolCoCreateVc und ProtocolCoDeleteVc angeben. Wenn der MCM zuvor eine MiniportCoCreateVc - oder MiniportCoDeleteVc-Funktion registriert hat. NDIS ignoriert die Einstiegspunkte für diese Funktionen, wenn NDIS den MCM-Treiber aufruft, um eine virtuelle Verbindung (Virtual Connection, VC) zu erstellen oder zu löschen. Daher übergibt NDIS einen NdisAfHandle-Wert für den anfänglichen Parameter an die von MCM bereitgestellte ProtocolCoCreateVc - oder ProtocolCoDeleteVc-Funktion anstelle des MiniportAdapterContext-Werts , den es an die MiniportCoCreateVc - oder MiniportCoDeleteVc-Funktion eines Nicht-MCM-Miniporttreibers übergeben würde.

Ein MCM-Treiber kann den CmOidRequestHandler-Member von NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS nicht auf seine MiniportCoOidRequest-Funktion festlegen. Der Treiber muss einen separaten Einstiegspunkt für eine ProtocolCoOidRequest-Funktion bereitstellen. Ein MCM-Treiber muss über eine ProtocolCoOidRequest-Funktion verfügen, um Aufruf-Manager-Anforderungen von CoNDIS-Clients verarbeiten zu können, und muss über eine ProtocolCoOidRequestComplete-Funktion .