Erweitern Minimieren

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

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

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)

IRQL

<= DISPATCH_LEVEL.

See also

MiniportCoRequest
NdisCoRequest
NdisMCmRequestComplete
NdisMCoRequestComplete
NdisRequest
NDIS_REQUEST
ProtocolCoRequest
ProtocolCoRequestComplete

 

 

Send comments about this topic to Microsoft

Anzeigen:
© 2014 Microsoft