NdisMCoOidRequestComplete function (ndis.h)

Article
04/18/2022

The NdisMCoOidRequestComplete function returns the final status of an OID requestthat a miniport driver's

MiniportCoOidRequest function returned NDIS_STATUS_PENDING for.

Syntax

void NdisMCoOidRequestComplete(
  [in] NDIS_HANDLE       MiniportAdapterHandle,
       NDIS_HANDLE       NdisMiniportVcHandle,
       PNDIS_OID_REQUEST Request,
  [in] NDIS_STATUS       Status
);

Parameters

[in] MiniportAdapterHandle

A miniport adapter handle that NDIS passed to the MiniportAdapterHandle parameter of the MiniportInitializeEx function.

NdisMiniportVcHandle

A handle that identifies the virtual connection (VC). The miniport driver obtained this handle as an input parameter to its MiniportCoCreateVc function, either when a client set up an outgoing call or when the call manager created a VC for a client-registered service access point (SAP). The call manager created the VC to indicate an incoming-call notification. If the request is not VC-specific, this parameter is NULL.

Request

A pointer to a buffer that is formatted as an NDIS_OID_REQUEST structure. The miniport driver obtained this pointer as an input parameter to its MiniportCoOidRequest function.

[in] Status

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

Return value

None

Remarks

A CoNDIS miniport driver that returns NDIS_STATUS_PENDING from its MiniportCoOidRequest function must call NdisMCoOidRequestComplete after the miniport driver has finished the request operation.

A call to NdisMCoOidRequestComplete causes a call to the ProtocolCoOidRequestComplete function of the overlying driver that called the NdisCoOidRequest function.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Target Platform	Desktop
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	Irql_MCO_Function(ndis)