NDIS_RESTART_ATTRIBUTES構造体 (ndis.h)

[アーティクル]
02/26/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

データ メンバー内の情報の NDIS オブジェクト識別子。たとえば、 Oid が OID_GEN_MINIPORT_RESTART_ATTRIBUTES、 Data メンバーには NDIS_RESTART_GENERAL_ATTRIBUTES 構造体。

DataLength

Data メンバーに格納されている情報の長さ (バイト単位)。

Data[1]

Oid メンバーで指定された OID に関連付けられている情報を格納するバッファー。

注釈

NDIS がドライバースタックを再起動すると、NDIS はミニポート、フィルター、プロトコルドライバーに再起動属性のリンクされたリストへのポインターを渡します。

ミニポートドライバーの MiniportRestart 関数を呼び出すと、NDIS は、の RestartAttributes メンバー内のミニポートドライバーにNDIS_RESTART_ATTRIBUTES構造体へのポインターを渡します。 NDIS_MINIPORT_RESTART_PARAMETERS 構造体。

フィルタードライバーの FilterRestart 関数を呼び出すと、NDIS は、NDIS_RESTART_ATTRIBUTES構造体へのポインターを、 の RestartAttributes メンバーのフィルタードライバーに渡します。 NDIS_FILTER_RESTART_PARAMETERS 構造体。

プロトコルバインディングを再起動すると、NDIS は、の RestartAttributes メンバー内のNDIS_RESTART_ATTRIBUTES構造体へのポインターを提供します。 NDIS_PROTOCOL_RESTART_PARAMETERS 構造体。プロトコルバインディングを再起動するために、NDIS はプロトコルドライバーの ProtocolNetPnPEvent 関数を呼び出します。の NetPnPEvent メンバー NDIS が ProtocolNetPnPEvent に渡す構造体NET_PNP_EVENT_NOTIFICATION、 NET_PNP_EVENT 構造体が含まれています。 NET_PNP_EVENT構造体は、NetEvent メンバーの NetEventRestart と Buffer メンバー内のNDIS_PROTOCOL_RESTART_PARAMETERS構造体へのポインターを指定します。

NDIS が NDIS ドライバーに渡す再起動属性ポインターが NULL の場合、ドライバーはドライバースタックの属性変更を伝達しないでください。このような状況では、ドライバーは変更したり、属性の変更を報告したりしないでください。

再起動属性ポインターが NULL でない場合、NDIS_RESTART_ATTRIBUTES構造体のリンクされたリストには、を含むエントリが少なくとも 1 つ含まれます。 NDIS_RESTART_GENERAL_ATTRIBUTES 構造体。残りのエントリには、メディア固有の属性が含まれます (存在する場合)。