NdisMCoOidRequestComplete function (ndis.h)

The NdisMCoOidRequestComplete function returns the final status of an OID request that 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

See also

MiniportCoCreateVc

MiniportCoOidRequest

MiniportInitializeEx

NDIS_OID_REQUEST

NdisCoOidRequest