NDIS_PROTOCOL_RESTART_PARAMETERS structure (ndis.h)

The NDIS_PROTOCOL_RESTART_PARAMETERS structure defines restart parameters for a protocol driver when NDIS calls the ProtocolNetPnPEvent function to indicate a NetEventRestart event.

Syntax

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;

Members

Header

The NDIS_OBJECT_HEADER structure for the NDIS_PROTOCOL_RESTART_PARAMETERS structure. NDIS sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS, the Revision member to NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1, and the Size member to NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1.

FilterModuleNameBuffer

A list of the names of the underlying filter modules. For each name, the buffer contains a USHORT value followed by a wide character string. Use the first USHORT value in the buffer to determine the length of the first string. Use the length of the first string to determine the start of the next string. Continue in this manner until the number of bytes that are retrieved from the buffer equals the number of bytes that are specified in the FilterModuleNameBufferLength member.

FilterModuleNameBufferLength

The length, in bytes, of the buffer in the FilterModuleNameBuffer member.

RestartAttributes

A pointer to the first entry in a list of NDIS_RESTART_ATTRIBUTES structures. Use the Next member of the NDIS_RESTART_ATTRIBUTES structure to get the next structure in the list.

BoundIfIndex

The NDIS network interface index of the highest-level interface that is stacked on the miniport adapter. That is, if there are virtual miniports or filter modules that are installed over the miniport adapter, this member is the IfIndex of the highest-level virtual miniport or filter module.

BoundIfNetluid

The NDIS NET_LUID value (that is also the network interface name (ifName in RFC 2863)) of the highest-level interface that is stacked on the miniport adapter. That is, if there are virtual miniports or filter modules that are installed over the miniport adapter, this member is the NET_LUID value of the highest-level virtual miniport or filter module.

Flags

Reserved for future use.

Remarks

NDIS passes an NDIS_PROTOCOL_RESTART_PARAMETERS structure to a protocol driver when it calls the ProtocolNetPnPEvent function to indicate a NetEventRestart event.

Each name that is specified in the buffer in the FilterModuleNameBuffer member is not guaranteed to be NULL-terminated. The USHORT value at the start of each string contains the length, in bytes, of the string. Protocol drivers should check the value of the FilterModuleNameBufferLength member before they access the buffer.

Requirements

See also

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent