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
| 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_Connection_Function(ndis) |