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
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. |
See also