NdisMCmOidRequestComplete macro (ndis.h)

The NdisMCmOidRequestComplete function returns the final status of a CoNDIS OID request that a miniport call manager (MCM) driver's ProtocolCoOidRequest function previously returned NDIS_STATUS_PENDING for.

Syntax

void NdisMCmOidRequestComplete(
   _AH_,
   _VH_,
   _PH_,
   _R_,
   _S_
);

Parameters

_AH_

An address family (AF) handle that NDIS passed to the MCM's ProtocolCoOidRequest function.

_VH_

A virtual connection (VC) handle that NDIS passed to the MCM'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 function specified a NULL VC handle.

_PH_

A party handle that NDIS passed to the MCM'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 function specified a NULL party handle.

_R_

A pointer to an NDIS_OID_REQUEST structure that the caller of the NdisCoOidRequest function supplied.

_S_

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

Return value

None

Remarks

A CoNDIS MCM that returns NDIS_STATUS_PENDING from its ProtocolCoOidRequest function must call the NdisMCmOidRequestComplete function after the MCM has finished the OID request operation.

After the MCM calls NdisMCmOidRequestComplete, NDIS calls the ProtocolCoOidRequestComplete function of the CoNDIS client that originally called the NdisCoOidRequest function.

For more information about the OIDs defined to use with CONDIS drivers, see NDIS OIDs.

Requirements

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

See also

NDIS_OID_REQUEST

NdisCoOidRequest

ProtocolCoOidRequest

ProtocolCoOidRequestComplete