estructura NDIS_RESTART_ATTRIBUTES (ndis.h)

Artículo
08/07/2023

La estructura NDIS_RESTART_ATTRIBUTES identifica una entrada de atributos en una lista vinculada de atributos de reinicio.

Sintaxis

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

Miembros

Next

Puntero a una estructura de NDIS_RESTART_ATTRIBUTES que puede usar para acceder al siguiente conjunto de atributos de reinicio en la lista vinculada de atributos. Si no hay atributos adicionales, este miembro es NULL.

Oid

Identificador del objeto NDIS para la información que se encuentra en el miembro Data . Por ejemplo, si Oid es OID_GEN_MINIPORT_RESTART_ATTRIBUTES, el miembro Data contiene un NDIS_RESTART_GENERAL_ATTRIBUTES estructura.

DataLength

Longitud, en bytes, de la información almacenada en el miembro Data .

Data[1]

Búfer que contiene la información asociada al OID que se especifica en el miembro Oid .

Comentarios

Cuando NDIS reinicia una pila de controladores, NDIS pasa un puntero a una lista vinculada de atributos de reinicio para miniportar, filtrar y controladores de protocolo.

Cuando llama a la función MiniportRestart de un controlador de miniporte, NDIS pasa un puntero a una estructura de NDIS_RESTART_ATTRIBUTES al controlador de minipuerto en el miembro RestartAttributes del elemento NDIS_MINIPORT_RESTART_PARAMETERS estructura.

Cuando llama a la función FilterRestart de un controlador de filtro, NDIS pasa un puntero a una estructura de NDIS_RESTART_ATTRIBUTES al controlador de filtro en el miembro RestartAttributes del elemento NDIS_FILTER_RESTART_PARAMETERS estructura.

Cuando reinicia un enlace de protocolo, NDIS proporciona un puntero a una estructura de NDIS_RESTART_ATTRIBUTES en el miembro RestartAttributes del elemento NDIS_PROTOCOL_RESTART_PARAMETERS estructura. Para reiniciar un enlace de protocolo, NDIS llama a la función ProtocolNetPnPEvent del controlador de protocolo. El miembro NetPnPEvent del NET_PNP_EVENT_NOTIFICATION estructura, que NDIS pasa a ProtocolNetPnPEvent, contiene una estructura NET_PNP_EVENT . La estructura NET_PNP_EVENT especifica NetEventRestart en el miembro NetEvent y un puntero a la estructura NDIS_PROTOCOL_RESTART_PARAMETERS del miembro Buffer .

Si el puntero de atributos de reinicio que NDIS pasa a los controladores NDIS es NULL, los controladores no deben propagar sus atributos cambia hacia arriba en la pila de controladores. En esta situación, los controladores no deben modificar ni notificar ningún cambio en los atributos.

Si el puntero de atributos de reinicio no es NULL, la lista vinculada de NDIS_RESTART_ATTRIBUTES estructuras tiene al menos una entrada que contiene una NDIS_RESTART_GENERAL_ATTRIBUTES estructura. El resto de las entradas, si las hay, contienen atributos específicos de medios.