NDIS_RESTART_ATTRIBUTES 結構 (ndis.h)

發行項
03/01/2024

NDIS_RESTART_ATTRIBUTES 結構會識別重新啟動屬性連結清單中的屬性專案。

語法

typedef struct _NDIS_RESTART_ATTRIBUTES {
  PNDIS_RESTART_ATTRIBUTES Next;
  NDIS_OID                 Oid;
  ULONG                    DataLength;
  UCHAR                    Data[1];
} NDIS_RESTART_ATTRIBUTES, *PNDIS_RESTART_ATTRIBUTES;

成員

Next

NDIS_RESTART_ATTRIBUTES結構的指標，可用來存取屬性連結清單中的下一組重新啟動屬性。如果沒有其他屬性，此成員為 NULL。

Oid

Data 成員中資訊的NDIS對象標識碼。例如，如果 Oid 是 OID_GEN_MINIPORT_RESTART_ATTRIBUTES，Data 成員包含 NDIS_RESTART_GENERAL_ATTRIBUTES 結構。

DataLength

儲存在數據成員中之資訊的長度，以位元組為單位。

Data[1]

緩衝區，其中包含與 Oid 成員中指定的 OID 相關聯的資訊。

備註

當 NDIS 重新啟動驅動程式堆疊時，NDIS 會將重新啟動屬性連結清單的指標傳遞至迷你埠、篩選和通訊協定驅動程式。

當它呼叫迷你埠驅動程式的 MiniportRestart 函式時，NDIS 會將指標傳遞至 restartAttributes 成員中的 miniport 驅動程式NDIS_RESTART_ATTRIBUTES結構 NDIS_MINIPORT_RESTART_PARAMETERS 結構。

當它呼叫篩選驅動程式的 FilterRestart 函式時，NDIS 會將指標傳遞給 restartAttributes 成員中的篩選驅動程式NDIS_RESTART_ATTRIBUTES結構 NDIS_FILTER_RESTART_PARAMETERS 結構。

重新啟動通訊協議系結時，NDIS 會在 RestartAttributes 成員中提供NDIS_RESTART_ATTRIBUTES結構的指標 NDIS_PROTOCOL_RESTART_PARAMETERS 結構。若要重新啟動通訊協議系結，NDIS 會呼叫通訊協定驅動程式的 ProtocolNetPnPEvent 函式。的 NetPnPEvent 成員 NET_PNP_EVENT_NOTIFICATION 結構，NDIS 會傳遞至 ProtocolNetPnPEvent，其中包含 NET_PNP_EVENT 結構。 NET_PNP_EVENT 結構指定 NetEvent 成員中的 NetEventRestart，以及 Buffer 成員中NDIS_PROTOCOL_RESTART_PARAMETERS結構的指標。

如果 NDIS 傳遞至 NDIS 驅動程式的重新啟動屬性指標為 NULL，驅動程式不應該將其屬性變更傳播至驅動程式堆疊。在此情況下，驅動程式不應修改或報告任何屬性變更。

如果重新啟動屬性指標不是 NULL，則NDIS_RESTART_ATTRIBUTES結構的連結清單至少有一個專案包含 NDIS_RESTART_GENERAL_ATTRIBUTES 結構。如果有的話，其餘的專案會包含媒體特定屬性。