NdisFGetOptionalSwitchHandlers 函数 (ndis.h)

Hyper-V 可扩展交换机扩展调用 NdisFGetOptionalSwitchHandlers 函数,以获取指向 Hyper-V 可扩展交换机处理程序函数的指针列表。

语法

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

参数

[in] NdisFilterHandle

标识此筛选器模块的 NDIS 句柄。 当 NDIS 调用扩展的 FilterAttach 函数时,它在 NdisFilterHandle 参数中传递了此句柄。

[out] NdisSwitchContext

指向NDIS_SWITCH_CONTEXT值的指针,该值标识扩展所附加到的可扩展交换机模块。 当扩展调用可扩展开关处理程序函数时,它必须将 NdisSwitchContext 参数设置为此句柄的值。

[in, out] NdisSwitchHandlers

指向调用方分配 的NDIS_SWITCH_OPTIONAL_HANDLERS 结构的指针。 如果调用成功,此结构将包含指向可扩展开关处理程序函数的指针列表。

有关这些处理程序函数的详细信息,请参阅 Hyper-V 可扩展交换机处理程序函数

注意在扩展调用 NdisFGetOptionalSwitchHandlers 之前,它必须初始化 NDIS_SWITCH_OPTIONAL_HANDLERS 结构的 Header 成员。
 

返回值

如果调用成功, NdisFGetOptionalSwitchHandlers 将返回NDIS_STATUS_SUCCESS。 否则,如果可扩展交换机扩展未绑定到基础可扩展交换机组件,则返回NDIS_STATUS_NOT_SUPPORTED。

注解

扩展从其 FilterAttach 函数调用 NdisFGetOptionalSwitchHandlers 函数。

如果扩展随多个 FilterMediaTypes INF 条目一起安装,则调用 NdisFGetOptionalSwitchHandlers 可让扩展确定它是绑定并附加到可扩展交换机的驱动程序堆栈还是物理网络适配器。 如果调用返回NDIS_STATUS_SUCCESS,扩展将附加到可扩展交换机驱动程序堆栈中。 如果调用返回NDIS_STATUS_NOT_SUPPORTED,则扩展将附加到物理网络适配器的驱动程序堆栈中。

有关可扩展交换机扩展的 FilterMediaTypes INF 条目的详细信息,请参阅 Hyper-V 可扩展交换机扩展的 INF 要求

要求

要求
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
目标平台 通用
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS