NdisMCoRequestComplete 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.

NdisMCoRequestComplete returns the final status of an OID_GEN_CO_XXX or connection-oriented medium-specific OID_XXX request for which the MiniportCoRequest function previously returned NDIS_STATUS_PENDING.

Syntax

VOID NdisMCoRequestComplete(
  _In_ NDIS_STATUS   Status,
  _In_ NDIS_HANDLE   MiniportAdapterHandle,
  _In_ PNDIS_REQUEST Request
);

Parameters

Status [in]
Specifies the final status of the requested operation, either NDIS_STATUS_SUCCESS or any driver-determined NDIS_STATUS_XXX except NDIS_STATUS_PENDING.
MiniportAdapterHandle [in]
Specifies the NDIS-supplied handle originally input to MiniportInitialize.
Request [in]
Pointer to a buffer formatted as an NDIS_REQUEST structure. The miniport driver obtained this pointer as an input parameter to its MiniportCoRequest function.

Return value

None

Remarks

A NIC driver that returns NDIS_STATUS_PENDING from its MiniportCoRequest function must call NdisMCoRequestComplete subsequently when the miniport driver has finished the requested operation.

A call to NdisMCoRequestComplete causes a call to the ProtocolCoRequestComplete function of the protocol that originally called NdisCoRequest with the given NdisRequest pointer.

An MCM driver that returns NDIS_STATUS_PENDING from its ProtocolCoRequest function must call NdisMCmRequestComplete, subsequently, rather than NdisMRequestComplete or NdisMCoRequestComplete.

Requirements

Target platform	Universal
Version	Not supported for NDIS 6.0 drivers in Windows Vista. Use NdisMCoOidRequestCompleteinstead. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP.
Header	Ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL