NDIS_MINIPORT_SS_CHARACTERISTICS 結構 (ndis.h)

發行項
02/26/2024

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 選擇性暫停閑置通知。