estrutura NDIS_RESTART_ATTRIBUTES (ndis.h)

Artigo
08/07/2023

A estrutura NDIS_RESTART_ATTRIBUTES identifica uma entrada de atributos em uma lista vinculada de atributos de reinicialização.

Sintaxe

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

Membros

Next

Um ponteiro para uma estrutura NDIS_RESTART_ATTRIBUTES que você pode usar para acessar o próximo conjunto de atributos de reinicialização na lista vinculada de atributos. Se não houver atributos adicionais, esse membro será NULL.

Oid

O identificador de objeto NDIS para as informações que estão no membro Data . Por exemplo, se Oid for OID_GEN_MINIPORT_RESTART_ATTRIBUTES, o membro Data contém um NDIS_RESTART_GENERAL_ATTRIBUTES estrutura.

DataLength

O comprimento, em bytes, das informações armazenadas no membro Dados .

Data[1]

Um buffer que contém as informações associadas ao OID especificado no membro Oid .

Comentários

Quando o NDIS reinicia uma pilha de driver, o NDIS passa um ponteiro para uma lista vinculada de atributos de reinicialização para miniportar, filtrar e drivers de protocolo.

Quando ele chama a função MiniportRestart de um driver de miniport, o NDIS passa um ponteiro para uma estrutura NDIS_RESTART_ATTRIBUTES para o driver de miniport no membro RestartAttributes do NDIS_MINIPORT_RESTART_PARAMETERS estrutura.

Quando chama a função FilterRestart de um driver de filtro, o NDIS passa um ponteiro para uma estrutura NDIS_RESTART_ATTRIBUTES para o driver de filtro no membro RestartAttributes do NDIS_FILTER_RESTART_PARAMETERS estrutura.

Quando reinicia uma associação de protocolo, o NDIS fornece um ponteiro para uma estrutura NDIS_RESTART_ATTRIBUTES no membro RestartAttributes do NDIS_PROTOCOL_RESTART_PARAMETERS estrutura. Para reiniciar uma associação de protocolo, o NDIS chama a função ProtocolNetPnPEvent de um driver de protocolo. O membro NetPnPEvent do NET_PNP_EVENT_NOTIFICATION estrutura, que o NDIS passa para ProtocolNetPnPEvent, contém uma estrutura NET_PNP_EVENT . A estrutura NET_PNP_EVENT especifica NetEventRestart no membro NetEvent e um ponteiro para a estrutura NDIS_PROTOCOL_RESTART_PARAMETERS no membro Buffer .

Se o ponteiro de atributos de reinicialização que o NDIS passa para drivers NDIS for NULL, os drivers não deverão propagar seus atributos para cima na pilha do driver. Nessa situação, os drivers não devem modificar ou relatar alterações de atributos.

Se o ponteiro de atributos de reinicialização não for NULL, a lista vinculada de estruturas de NDIS_RESTART_ATTRIBUTES terá pelo menos uma entrada que contém uma NDIS_RESTART_GENERAL_ATTRIBUTES estrutura. O restante das entradas, se houver, contêm atributos específicos da mídia.