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