estrutura NDIS_PROTOCOL_RESTART_PARAMETERS (ndis.h)

A estrutura NDIS_PROTOCOL_RESTART_PARAMETERS define parâmetros de reinicialização para um driver de protocolo quando o NDIS chama a função ProtocolNetPnPEvent para indicar um evento NetEventRestart .

Sintaxe

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;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_PROTOCOL_RESTART_PARAMETERS. O NDIS define o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS, o membro Revision como NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1 e o membro Size como NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1.

FilterModuleNameBuffer

Uma lista dos nomes dos módulos de filtro subjacentes. Para cada nome, o buffer contém um valor USHORT seguido por uma cadeia de caracteres larga. Use o primeiro valor USHORT no buffer para determinar o comprimento da primeira cadeia de caracteres. Use o comprimento da primeira cadeia de caracteres para determinar o início da próxima cadeia de caracteres. Continue dessa maneira até que o número de bytes recuperados do buffer seja igual ao número de bytes especificados no membro FilterModuleNameBufferLength .

FilterModuleNameBufferLength

O comprimento, em bytes, do buffer no membro FilterModuleNameBuffer .

RestartAttributes

Um ponteiro para a primeira entrada em uma lista de estruturas de NDIS_RESTART_ATTRIBUTES . Use o membro Next da estrutura NDIS_RESTART_ATTRIBUTES para obter a próxima estrutura na lista.

BoundIfIndex

O índice da interface de rede NDIS da interface de nível mais alto que é empilhada no adaptador de miniporto. Ou seja, se houver miniportos virtuais ou módulos de filtro instalados no adaptador de miniporto, esse membro será o IfIndex do módulo de miniporto virtual ou filtro de nível mais alto.

BoundIfNetluid

O NDIS NET_LUID valor (que também é o nome da interface de rede (ifName no RFC 2863)) da interface de nível mais alto que é empilhada no adaptador de miniporte. Ou seja, se houver miniportos virtuais ou módulos de filtro instalados no adaptador de miniporto, esse membro será o valor NET_LUID do miniporto virtual de nível mais alto ou do módulo de filtro.

Flags

Reservado para uso futuro.

Comentários

O NDIS passa uma estrutura NDIS_PROTOCOL_RESTART_PARAMETERS para um driver de protocolo quando chama a função ProtocolNetPnPEvent para indicar um evento NetEventRestart .

Não há garantia de que cada nome especificado no buffer no membro FilterModuleNameBuffer seja encerrado em NULL. O valor USHORT no início de cada cadeia de caracteres contém o comprimento, em bytes, da cadeia de caracteres. Os drivers de protocolo devem marcar o valor do membro FilterModuleNameBufferLength antes de acessarem o buffer.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Cabeçalho ndis.h (inclua Ndis.h)

Confira também

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent