共用方式為


NDIS_PROTOCOL_RESTART_PARAMETERS結構(ndis.h)

當 NDIS 呼叫 ProtocolNetPnPEvent 函式來 指出 netEventRestart 事件時,NDIS_PROTOCOL_RESTART_PARAMETERS結構會定義通訊協定驅動程式的重新啟動參數。

語法

typedef struct _NDIS_PROTOCOL_RESTART_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  PUCHAR                   FilterModuleNameBuffer;
  ULONG                    FilterModuleNameBufferLength;
  PNDIS_RESTART_ATTRIBUTES RestartAttributes;
  NET_IFINDEX              BoundIfIndex;
  NET_LUID                 BoundIfNetluid;
  ULONG                    Flags;
} NDIS_PROTOCOL_RESTART_PARAMETERS, *PNDIS_PROTOCOL_RESTART_PARAMETERS;

成員

Header

NDIS_PROTOCOL_RESTART_PARAMETERS 結構的 NDIS_OBJECT_HEADER 結構。 NDIS 會將 Header 指定為NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS的 Type 成員、Revision 成員NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1,以及 Size 成員NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1。

FilterModuleNameBuffer

基礎篩選模組的名稱清單。 針對每個名稱,緩衝區包含USHORT值,後面接著寬字元字串。 使用緩衝區中的第一個USHORT值來判斷第一個字串的長度。 使用第一個字串的長度來判斷下一個字串的開頭。 以這種方式繼續,直到從緩衝區擷取的位元元組數目等於 filterModuleNameBufferLength 成員 中指定的位元組數目。

FilterModuleNameBufferLength

FilterModuleNameBuffer 中緩衝區的長度,以位元組為單位, 成員。

RestartAttributes

NDIS_RESTART_ATTRIBUTES 結構清單中的第一個項目指標。 使用 NDIS_RESTART_ATTRIBUTES 結構的 Next 成員,取得清單中的下一個結構。

BoundIfIndex

迷你埠配接器上堆疊之最高層級介面的 NDIS 網路介面索引。 也就是說,如果有透過迷你埠配接器安裝的虛擬迷你埠或篩選模組,則此成員是最高層級虛擬迷你埠或篩選模組的 IfIndex

BoundIfNetluid

NDIS NET_LUID 值(也就是小型埠適配卡上堆棧的最上層介面的網路介面名稱(ifName in RFC 2863)。 也就是說,如果有透過迷你埠配接器安裝的虛擬迷你埠或篩選模組,則此成員是最高層級虛擬迷你埠或篩選模組NET_LUID值。

Flags

保留供日後使用。

言論

NDIS 會在呼叫 ProtocolNetPnPEvent 函式時,將NDIS_PROTOCOL_RESTART_PARAMETERS結構傳遞至通訊協定驅動程式,以指出 netEventRestart 事件

FilterModuleNameBuffer 成員之緩衝區中指定的每個名稱不保證都會以 NULL 終止。 每個字串開頭的 USHORT 值包含字串的長度,以位元組為單位。 通訊協議驅動程式應該先檢查 FilterModuleNameBufferLength 成員的值,再存取緩衝區。

要求

要求 價值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
標頭 ndis.h (包括 Ndis.h)

另請參閱

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent