NdisMCoActivateVcComplete (NDIS 5.1) function

Article
06/19/2017

Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisMCoActivateVcComplete notifies NDIS and the call manager that the miniport driver has finished processing a CM-initiated activate-VC request, for which the NIC driver previously returned NDIS_STATUS_PENDING.

Syntax

VOID NdisMCoActivateVcComplete(
  _In_ NDIS_STATUS         Status,
  _In_ NDIS_HANDLE         NdisVcHandle,
  _In_ PCO_CALL_PARAMETERS CallParameters
);

Parameters

Status [in]
Specifies the final status of the activate-VC operation, which can be NDIS_STATUS_SUCCESS or any NDIS_STATUS_XXX except NDIS_STATUS_PENDING.
NdisVcHandle [in]
Specifies the handle identifying the VC. The caller obtained this handle from its per-VC state, designated by the MiniportVcContext passed as an input parameter to its MiniportCoActivateVc function.
CallParameters [in]
Pointer to a structure of type CO_CALL_PARAMETERS, supplied by the call manager, specifying the call and media parameters for the VC activation.

Return value

None

Remarks

A connection-oriented NIC driver must call NdisMCoActivateVcComplete if its MiniportCoActivateVc function previously returned NDIS_STATUS_PENDING in response to a request to activate or reactivate the VC identified by the given NdisVcHandle. The call manager, which initiated the VC activation with a call to NdisCmActivateVc, cannot notify NDIS or its client whether transfers on the VC can be made using the supplied call parameters until the miniport driver calls NdisMCoActivateVcComplete.

If the miniport driver finds the CM-supplied call parameters unacceptable, it fails the VC activation when it calls NdisMCoActivateVcComplete. Failing the initial activation of a VC can cause the protocol that created the VC to tear it down. If the miniport driver fails a request to reactivate an established VC with new call parameters, it must restore the original call parameters established for that VC. Depending on the nature of the network medium, a miniport driver can modify the media parameters if the round-up and/or round-down flag(s) are set before it calls NdisMCoActivateVcComplete.

A call to NdisMCoActivateVcComplete causes NDIS to call the ProtocolCmActivateVcComplete function of the call manager that originally requested the VC activation.

Requirements

Target platform	Universal
Version	See NdisMCoActivateVcComplete.
Header	Ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Share via