NDIS_RESTART_ATTRIBUTES (Compact 2013)

3/26/2014

This structure identifies an attributes entry in a linked list of restart attributes.

Syntax

typedef struct _NDIS_RESTART_ATTRIBUTES {
  PNDIS_RESTART_ATTRIBUTES  Next;
  NDIS_OID  Oid;
  ULONG  DataLength;
  DECLSPEC_ALIGN(MEMORY_ALLOCATION_ALIGNMENT) UCHAR  Data[1];
} NDIS_RESTART_ATTRIBUTES, *PNDIS_RESTART_ATTRIBUTES;

Members

  • Next
    A pointer to an NDIS_RESTART_ATTRIBUTES structure that you can use to access the next set of restart attributes in the linked list of attributes. If there are no additional attributes, this member is NULL.
  • DataLength
    The length, in bytes, of the information that is stored in the Data member.
  • Data
    A buffer that contains the information that is associated with the OID that is specified in the Oid member.

Remarks

When NDIS restarts a driver stack, NDIS passes a pointer to a linked list of restart attributes to miniport, filter, and protocol drivers.

When it calls a miniport driver's MiniportRestart function, NDIS passes a pointer to an NDIS_RESTART_ATTRIBUTES structure to the miniport driver in the RestartAttributes member of the NDIS_MINIPORT_RESTART_PARAMETERS structure.

When it calls a filter driver's FilterRestart function, NDIS passes a pointer to an NDIS_RESTART_ATTRIBUTES structure to the filter driver in the RestartAttributes member of the NDIS_FILTER_RESTART_PARAMETERS structure.

When it restarts a protocol binding, NDIS provides a pointer to an NDIS_RESTART_ATTRIBUTES structure in the RestartAttributes member of the NDIS_PROTOCOL_RESTART_PARAMETERS structure. To restart a protocol binding, NDIS calls a protocol driver's ProtocolNetPnPEvent function. The NetPnPEvent member of the NET_PNP_EVENT_NOTIFICATION structure, that NDIS passes to ProtocolNetPnPEvent, contains a NET_PNP_EVENT structure. The NET_PNP_EVENT structure specifies NetEventRestart in the NetEvent member and a pointer to the NDIS_PROTOCOL_RESTART_PARAMETERS structure in the Buffer member.

If the restart attributes pointer that NDIS passes to NDIS drivers is NULL, the drivers should not propagate their attributes changes up the driver stack. In this situation, drivers should not modify, or report any attributes changes.

If the restart attributes pointer is not NULL, the linked list of NDIS_RESTART_ATTRIBUTES structures has at least one entry that contains an NDIS_RESTART_GENERAL_ATTRIBUTES structure. The rest of the entries, if any, contain media-specific attributes.

Requirements

Header

ndis.h

See Also

Reference

Miniport Driver Structures
FilterRestart
MiniportRestart
NDIS_FILTER_RESTART_PARAMETERS
NDIS_MINIPORT_RESTART_PARAMETERS
NDIS_PROTOCOL_RESTART_PARAMETERS
NDIS_RESTART_GENERAL_ATTRIBUTES
NET_PNP_EVENT_NOTIFICATION
OID_GEN_MINIPORT_RESTART_ATTRIBUTES
ProtocolNetPnPEvent