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

See also

MiniportCoRequest

MiniportQueryInformation

MiniportSetInformation

NdisCoRequest

NdisCoRequestComplete

NdisMCmRequestComplete

NdisRequest

NDIS_REQUEST

ProtocolCoRequest

ProtocolCoRequestComplete

 

 

Send comments about this topic to Microsoft