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 を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent