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

NdisCoRequestComplete returns the final status of an OID_GEN_CO_XXX request for which the call manager's or client's ProtocolCoRequest or ProtocolCoRequest function previously returned NDIS_STATUS_PENDING.

Syntax

VOID NdisCoRequestComplete(
  _In_     NDIS_STATUS   Status,
  _In_     NDIS_HANDLE   NdisAfHandle,
  _In_opt_ NDIS_HANDLE   NdisVcHandle,
  _In_opt_ NDIS_HANDLE   NdisPartyHandle,
  _In_     PNDIS_REQUEST NdisRequest
);

Parameters

Status [in]
Specifies the final status of the requested operation, either NDIS_STATUS_SUCCESS or any protocol-determined NDIS_STATUS_XXX except NDIS_STATUS_PENDING.
NdisAfHandle [in]
Specifies the AF handle stored in the caller's per-AF state, designated by the ProtocolAfContext passed in to the caller's ProtocolCl/CmRequest function.
NdisVcHandle [in, optional]
Specifies the VC handle stored in the caller's per-VC state, designated by ProtocolVcContext passed in to the caller's ProtocolCl/CmRequest function, or this parameter is NULL if the caller of NdisCoRequest passed it a NULL VC handle.
NdisPartyHandle [in, optional]
Specifies the party handle stored in the caller's per-party state, designated by the ProtocolPartyContext passed in to the caller's ProtocolCl/CmRequest function, or this parameter is NULL if the caller of NdisCoRequest passed it a NULL party handle.
NdisRequest [in]
Pointer to a buffer formatted as an NDIS_REQUEST structure, which the caller of NdisCoRequest supplied.

Return value

None

Remarks

A call to NdisCoRequestComplete causes a call to the ProtocolCoRequestComplete function of the driver that originally called NdisCoRequest with the given handle(s) and NdisRequest pointer.

Any protocol driver that returns NDIS_STATUS_PENDING from its ProtocolCoRequest function must call NdisCoRequestComplete subsequently when the driver has finished the requested operation.

Only clients and stand-alone call managers, which register themselves with NDIS as protocols, can call NdisCoRequestComplete. Connection-oriented NIC drivers that provide integrated call-management support call NdisMCmRequestComplete or NdisMCoRequestComplete instead, depending on whether the NIC driver's ProtocolCoRequest or MiniportCoRequest, respectively, handled the client's request.

Requirements

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

Partager via