NdisCoOidRequestComplete function

The NdisCoOidRequestComplete function returns the final status of an OID request that a CoNDIS client's or stand-alone call manager's ProtocolCoOidRequest function previously returned NDIS_STATUS_PENDING for.

Syntax

VOID NdisCoOidRequestComplete(
  _In_     NDIS_HANDLE       NdisAfHandle,
  _In_opt_ NDIS_HANDLE       NdisVcHandle,
  _In_opt_ NDIS_HANDLE       NdisPartyHandle,
  _In_     PNDIS_OID_REQUEST OidRequest,
  _In_     NDIS_STATUS       Status
);

Parameters

NdisAfHandle

An address family (AF) handle that NDIS passed to the client or stand-alone call manager's ProtocolCoOidRequest function.

NdisVcHandle

A virtual connection (VC) handle that NDIS passed to the client or stand-alone call manager's ProtocolCoOidRequest function. A NULL value for this parameter indicates that the request is not VC-specific. This parameter is NULL if the caller of the NdisCoOidRequest or NdisMCmOidRequest function specified a NULL VC handle.

NdisPartyHandle

A party handle that NDIS passed to the client or stand-alone call manager's ProtocolCoOidRequest function. A NULL value for this parameter indicates that the request is not party-specific. This parameter is NULL if the caller of the NdisCoOidRequest or NdisMCmOidRequest function specified a NULL party handle.

OidRequest

A pointer to a buffer that is formatted as an NDIS_OID_REQUEST structure. The caller of the NdisCoOidRequest or NdisMCmOidRequest function supplied this buffer.

Status

The final status of the request operation, either NDIS_STATUS_SUCCESS, or any driver-determined NDIS_STATUS_XXX status value except NDIS_STATUS_PENDING.

Return Value

None

Remarks

A CoNDIS protocol driver that returns NDIS_STATUS_PENDING from its ProtocolCoOidRequest function must call NdisCoOidRequestComplete after the protocol driver has finished the request operation.

After a driver calls NdisCoOidRequestComplete, NDIS calls the ProtocolCoOidRequestComplete function of the driver that originally called the NdisCoOidRequest or NdisMCmOidRequest function.

Only clients and stand-alone call managers, which register themselves with NDIS as protocol drivers, can call NdisCoOidRequestComplete. Miniport call managers (MCMs) call the NdisMCmOidRequestComplete function or NdisMCoOidRequestComplete instead, depending on whether the MCM driver's ProtocolCoOidRequest or MiniportCoOidRequest function, respectively, handled the client's request.

Requirements

   
Windows Driver kit version
Target platform Desktop
Minimum KMDF version
Minimum UMDF version
Header ndis.h (include Ndis.h)
Library
IRQL <= DISPATCH_LEVEL
DDI compliance rules Irql_Connection_Function

See Also

MiniportCoOidRequest
NDIS_OID_REQUEST
NdisCoOidRequest
NdisMCmOidRequest
NdisMCmOidRequestComplete
NdisMCoOidRequestComplete
ProtocolCoOidRequest
ProtocolCoOidRequestComplete

Send comments about this topic to Microsoft