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) |