NdisCoOidRequestComplete 函数 (ndis.h)

项目
08/07/2023

NdisCoOidRequestComplete 函数返回 OID 请求的最终状态，而 CoNDIS 客户端或独立调用管理器的 ProtocolCoOidRequest 函数以前为其返回NDIS_STATUS_PENDING。

语法

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

参数

[in] NdisAfHandle

地址系列 (AF) 处理 NDIS 传递给客户端或独立呼叫管理器的 ProtocolCoOidRequest 函数。

[in, optional] NdisVcHandle

虚拟连接 (VC) 处理 NDIS 传递给客户端或独立调用管理器的 ProtocolCoOidRequest 函数。此参数的 NULL 值指示请求不是特定于 VC 的。如果NdisCoOidRequest 或 NdisMCmOidRequest 函数的调用方指定 NULL VC 句柄，则此参数为 NULL。

[in, optional] NdisPartyHandle

一方处理 NDIS 传递给客户端或独立调用管理器的 ProtocolCoOidRequest 函数。此参数的 NULL 值指示请求不是特定于参与方的。如果NdisCoOidRequest 或 NdisMCmOidRequest 函数的调用方指定 NULL 方句柄，则此参数为 NULL。

[in] OidRequest

指向格式化为NDIS_OID_REQUEST结构的缓冲区的指针。 NdisCoOidRequest 或 NdisMCmOidRequest 函数的调用方提供了此缓冲区。

[in] Status

请求操作的最终状态（NDIS_STATUS_SUCCESS）或驱动程序确定的任何NDIS_STATUS_XXX 状态值（NDIS_STATUS_PENDING除外）。

返回值

无

备注

从其 ProtocolCoOidRequest 函数返回NDIS_STATUS_PENDING的 CoNDIS 协议驱动程序必须在协议驱动程序完成请求操作后调用 NdisCoOidRequestComplete 。

驱动程序调用 NdisCoOidRequestComplete 后，NDIS 调用最初调用 NdisCoOidRequest 函数或 NdisMCmOidRequest 函数的驱动程序的 ProtocolCoOidRequestComplete 函数。

只有向 NDIS 注册为协议驱动程序的客户端和独立调用管理器才能调用 NdisCoOidRequestComplete。微型端口呼叫管理器 (MMC) 调用 NdisMCmOidRequestComplete 函数或相反，根据 MCM 驱动程序的 ProtocolCoOidRequest 还是 MiniportCoOidRequest 函数分别处理客户端的请求，NdisMCoOidRequestComplete。

要求

要求	值
最低受支持的客户端	在 NDIS 6.0 及更高版本中受支持。
目标平台	桌面
标头	ndis.h (包括 Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	Irql_Connection_Function (ndis)