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值 ( ，亦即在 RFC 2863 中的網路介面 名稱 (，) ) 堆棧在迷你埠適配卡上的最上層介面。 也就是說，如果有透過迷你埠配接器安裝的虛擬迷你埠或篩選模組，則此成員是最高層級虛擬迷你埠或篩選模組的NET_LUID值。

Flags

保留供未來使用。

備註

當 NDIS 呼叫 ProtocolNetPnPEvent 函式以指出 NetEventRestart 事件時，會將NDIS_PROTOCOL_RESTART_PARAMETERS結構傳遞至通訊協定驅動程式。

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

規格需求

另請參閱

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent