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 [in]

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

NdisVcHandle [in, optional]

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 [in, optional]

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 [in]

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 [in]

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

Version

Supported in NDIS 6.0 and later.

Header

Ndis.h (include Ndis.h)

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

Show:
© 2014 Microsoft. All rights reserved.