NDIS_PROTOCOL_RESTART_PARAMETERS構造体 (ndis.h)
NDIS_PROTOCOL_RESTART_PARAMETERS構造体は、NDIS が ProtocolNetPnPEvent 関数を呼び出して、NetEventRestart イベントを示すときに、プロトコル ドライバーの再起動パラメーターを定義します。
構文
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 ヘッダー が指定する構造体の 型 メンバーを設定NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS、リビジョン メンバーをNDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1、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 RFC 2863)) ミニポート アダプターに積み重ねられた最上位のインターフェイスの値。 つまり、ミニポート アダプター経由でインストールされている仮想ミニポートまたはフィルター モジュールがある場合、このメンバーは、最上位レベルの仮想ミニポートまたはフィルター モジュールのNET_LUID値です。
Flags
将来の使用のために予約されています。
備考
NDIS は、ProtocolNetPnPEvent 関数を呼び出して、NetEventRestart イベントを示すときに、プロトコル ドライバーにNDIS_PROTOCOL_RESTART_PARAMETERS構造体を渡します。
FilterModuleNameBuffer メンバー内のバッファーで指定された各名前は、NULL で終わるとは限りません。 各文字列の先頭にある USHORT 値には、文字列の長さ (バイト単位) が含まれます。 プロトコル ドライバーは、バッファーにアクセスする前に、FilterModuleNameBufferLength メンバーの値を確認する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.0 以降でサポートされています。 |
| ヘッダー | ndis.h (Ndis.h を含む) |