MiniportCoDeactivateVc (NDIS 5.1) function
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.
The MiniportCoDeactivateVc function is required for connection-oriented miniports. MiniportCoDeactivateVc is called by NDIS to indicate that a VC is being marked as unusable.
Syntax
NDIS_STATUS MiniportCoDeactivateVc(
_In_ NDIS_HANDLE MiniportVcContext
);
Parameters
- MiniportVcContext [in]
Specified the handle to a miniport driver-allocated context area in which the miniport driver maintains state information per-VC. The miniport driver supplied this handle to NDIS from its MiniportCoCreateVc function.
Return value
| Return code | Description |
|---|---|
| NDIS_STATUS_SUCCESS | Indicates that the miniport driver successfully halted any communication across the VC and marked it as unusable. |
| NDIS_STATUS_PENDING | Indicates that the miniport driver will complete the request to halt the VC asynchronously. When the miniport driver has completed halting the VC, it must then call NdisMCoDeactivateVcComplete to signal NDIS that this operation has been completed. |
Remarks
MiniportCoDeactivateVc communicates with its network adapter to terminate all communication across this VC (in other words, deprogramming receive or send buffers on the adapter). The miniport driver should also mark the VC, it its context area, as being inactive to prevent any further communication across the VC.
There is not a one-to-one relationship between calls to MiniportCoActivateVc and MiniportCoDeactivateVc. While NDIS may call MiniportCoActivateVc multiple times on a single VC, only one call to MiniportCoDeactivateVc is made to shut down a virtual connection. For example, a VC can be reused for different calls possibly causing multiple calls to MiniportCoActivateVc.
Requirements
Target platform |
Desktop |
Version |
See MiniportCoDeactivateVc. |
Header |
Ndis.h (include Ndis.h) |
See also