NDIS_MINIPORT_SS_CHARACTERISTICS 结构 (ndis.h)

项目
08/07/2023

NDIS_MINIPORT_SS_CHARACTERISTICS 结构指定指向微型端口驱动程序的 NDIS 选择性挂起处理程序函数的指针。 NDIS 调用这些函数，以在选择性挂起操作期间向驱动程序发出空闲通知。

语法

typedef struct _NDIS_MINIPORT_SS_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                        Header;
  ULONG                                     Flags;
  MINIPORT_IDLE_NOTIFICATION_HANDLER        IdleNotificationHandler;
  MINIPORT_CANCEL_IDLE_NOTIFICATION_HANDLER CancelIdleNotificationHandler;
} NDIS_MINIPORT_SS_CHARACTERISTICS, *PNDIS_MINIPORT_SS_CHARACTERISTICS;

成员

Header

NDIS_MINIPORT_SS_CHARACTERISTICS 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将 Header 的 Type 成员设置为 NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS。若要指定 NDIS_MINIPORT_SS_CHARACTERISTICS 结构的版本，驱动程序必须将 Header 的 Revision 成员设置为以下值：

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将 Size 成员设置为 NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。此成员是为 NDIS 保留的。

IdleNotificationHandler

指向微型端口驱动程序的 MiniportIdleNotification 函数的指针。

CancelIdleNotificationHandler

指向微型端口驱动程序的 MiniportCancelIdleNotification 函数的指针。

注解

若要为 NDIS 选择性挂起注册处理程序函数，微型端口驱动程序在调用其 MiniportSetOptions 函数时遵循以下步骤：

微型端口驱动程序使用指向处理程序函数的指针初始化 NDIS_MINIPORT_SS_CHARACTERISTICS 结构。
然后，微型端口驱动程序调用 NdisSetOptionalHandlers 并将 OptionalHandlers 参数设置为指向 NDIS_MINIPORT_SS_CHARACTERISTICS 结构的指针。

有关如何处理 NDIS 选择性挂起的空闲通知的详细信息，请参阅 NDIS 选择性挂起空闲通知。