NdisMSynchronizeWithInterruptEx 函数 (ndis.h)

  • 项目

微型端口驱动程序调用 NdisMSynchronizeWithInterruptEx 函数，以将微型端口驱动程序提供的函数的执行与 MiniportInterrupt 函数同步。

语法

BOOLEAN NdisMSynchronizeWithInterruptEx(
  [in] NDIS_HANDLE                            NdisInterruptHandle,
  [in] ULONG                                  MessageId,
  [in] MINIPORT_SYNCHRONIZE_INTERRUPT_HANDLER SynchronizeFunction,
  [in] PVOID                                  SynchronizeFunction,
  [in] PVOID                                  SynchronizeContext
);

参数

[in] NdisInterruptHandle

微型端口驱动程序在上一次调用 中获取的中断句柄 NdisMRegisterInterruptEx 函数。

[in] MessageId

驱动程序必须与之同步的消息信号中断。 如果 NDIS 未为驱动程序授予消息信号中断，NDIS 将忽略此参数。 MessageId 是 IO_INTERRUPT_MESSAGE_INFO_ENTRY 结构 IO_INTERRUPT_MESSAGE_INFO 结构。 当驱动程序成功向 NdisMRegisterInterruptEx 函数注册 MSI 时，NDIS 会向 MessageInfoTable 成员处的关联IO_INTERRUPT_MESSAGE_INFO结构传递指针。

[in] SynchronizeFunction

驱动程序的 入口点 MiniportSynchronizeInterrupt 函数。

[in] SynchronizeFunction

驱动程序的 入口点 MiniportSynchronizeInterrupt 函数。

[in] SynchronizeContext

指向微型端口驱动程序确定的上下文区域的指针，该上下文区域传递到 SynchronizeContext 上的 MiniportSynchronizeInterrupt 函数。

返回值

NdisMSynchronizeWithInterruptEx 返回 MiniportSynchronizeInterrupt 返回的布尔值。

注解

向 NdisMRegisterInterruptEx 注册中断的微型端口驱动程序使用 NdisMSynchronizeWithInterruptEx。 的值 MiniportSynchronizeInterrupt 函数返回也由 NdisMSynchronizeWithInterruptEx 返回。 此传播值向调用方提供状态。

与在 DIRQL 中运行的任何其他驱动程序函数共享资源的任何微型端口驱动程序函数必须使用 NdisMSynchronizeWithInterruptEx 来同步其对这些资源的访问。 MiniportSynchronizeInterrupt 函数也在 DIRQL 上运行，共享资源受系统分配的旋转锁保护。 因此， MiniportInterrupt 函数和调用方可保护共享资源免受同时访问。

NdisMSynchronizeWithInterruptEx 释放系统旋转锁，并在调用方返回控制权之前还原其原始 IRQL。

有关获取和释放 NDIS 旋转锁的详细信息，请参阅 网络驱动程序中的同步和通知。

要求

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

另请参阅

IO_INTERRUPT_MESSAGE_INFO

IO_INTERRUPT_MESSAGE_INFO_ENTRY

MiniportInterrupt

MiniportSynchronizeInterrupt

NdisMRegisterInterruptEx