NdisCoOidRequestComplete function (ndis.h)

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, optional] NDIS_HANDLE       NdisVcHandle,
  [in, optional] NDIS_HANDLE       NdisPartyHandle,
  [in]           PNDIS_OID_REQUEST OidRequest,
  [in]           NDIS_STATUS       Status
);

Parameters

[in] NdisAfHandle

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

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

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

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

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

See also

MiniportCoOidRequest

NDIS_OID_REQUEST

NdisCoOidRequest

NdisMCmOidRequest

NdisMCmOidRequestComplete

NdisMCoOidRequestComplete

ProtocolCoOidRequest