estrutura NDIS_PORT_CHARACTERISTICS (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_PORT_CHARACTERISTICS especifica as características de uma porta NDIS. Para obter mais informações sobre portas NDIS, consulte Portas NDIS.

Sintaxe

typedef struct _NDIS_PORT_CHARACTERISTICS {
  NDIS_OBJECT_HEADER            Header;
  NDIS_PORT_NUMBER              PortNumber;
  ULONG                         Flags;
  NDIS_PORT_TYPE                Type;
  NDIS_MEDIA_CONNECT_STATE      MediaConnectState;
  ULONG64                       XmitLinkSpeed;
  ULONG64                       RcvLinkSpeed;
  NET_IF_DIRECTION_TYPE         Direction;
  NDIS_PORT_CONTROL_STATE       SendControlState;
  NDIS_PORT_CONTROL_STATE       RcvControlState;
  NDIS_PORT_AUTHORIZATION_STATE SendAuthorizationState;
  NDIS_PORT_AUTHORIZATION_STATE RcvAuthorizationState;
} NDIS_PORT_CHARACTERISTICS, *PNDIS_PORT_CHARACTERISTICS;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_PORT_CHARACTERISTICS . Defina o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision como NDIS_PORT_CHARACTERISTICS_REVISION_1 e o membro Size como NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1.

PortNumber

O número da porta NDIS associada a essa estrutura NDIS_PORT_CHARACTERISTICS . O valor PortNumber é um valor NDIS_PORT_NUMBER, que tem um tipo de dados ULONG e é válido de zero a 0xffffff, em que zero é reservado para a porta padrão.

Flags

Uma combinação OR bit a bit dos sinalizadores de características da porta ou zero se nenhum sinalizador estiver definido. Atualmente, há um sinalizador.

Se o sinalizador NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS estiver definido, o NDIS ignorará as configurações de estado de autenticação e usará o estado de autenticação padrão. Um driver de miniporta pode usar esse sinalizador para solicitar que o NDIS use as configurações de estado de autenticação padrão para as portas alocadas e ativadas. Se o driver de miniporta controlar a porta padrão, quando o driver de miniporto ativar a porta padrão, o driver poderá definir NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS para ativar a porta padrão com as configurações de estado de autenticação padrão.

Type

O tipo de porta NDIS. Para obter mais informações, consulte Tipos de portas NDIS. Esse tipo pode ser um dos seguintes valores:

NdisPortTypeUndefined

O tipo de porta padrão.

NdisPortTypeBridge

Reservado para uso do sistema.

NdisPortTypeRasConnection

Uma conexão RAS (Serviço de Acesso Remoto).

NdisPortType8021xSupplicant

Uma estação sem fio remota associada a um ponto de acesso neste computador host.

NdisPortTypeNdisImPlatform

Reservado para uso do sistema.

Nota Esse valor tem suporte apenas no NDIS 6.30 e posterior.

MediaConnectState

O estado de conexão de mídia da porta. Esse estado é a mesma informação que o OID_GEN_MEDIA_CONNECT_STATUS_EX Retorna OID.

XmitLinkSpeed

A velocidade do link de transmissão da porta em bits por segundo. Um valor de -1 neste membro indica que a velocidade do link de transmissão é desconhecida.

RcvLinkSpeed

A velocidade do link de recebimento da porta, em bits por segundo. Um valor de -1 neste membro indica que a velocidade do link de recebimento é desconhecida.

Direction

Um NET_IF_DIRECTION_TYPE tipo de direção de interface de rede NDIS.

SendControlState

O estado de controle da porta para operações de envio. Esse membro deve conter um dos seguintes valores:

NdisPortControlStateUnknown

O estado de controle da porta para operações de envio é desconhecido.

NdisPortControlStateControlled

A porta está em um estado controlado para operações de envio. Ou seja, a porta requer autorização.

NdisPortControlStateUncontrolled

A porta está em um estado não controlado para operações de envio. Ou seja, a porta não requer autorização.

RcvControlState

O estado de controle da porta para operações de recebimento. Esse membro deve conter um dos seguintes valores:

NdisPortControlStateUnknown

O estado de controle da porta para operações de recebimento é desconhecido.

NdisPortControlStateControlled

A porta está em um estado controlado para operações de recebimento (ou seja, a porta requer autorização) e o valor no membro SendAuthorizationState determina o estado de autenticação.

NdisPortControlStateUncontrolled

A porta está em um estado descontrolado para operações de recebimento. Portanto, a autenticação não se aplica a essa porta.

SendAuthorizationState

O estado de autorização da porta para operações de envio. Ignore esse membro se o membro SendControlState estiver definido como NdisPortControlStateUncontrolled.

SendAuthorizationState deve conter um dos seguintes valores:

NdisPortAuthorizationUnknown

O estado de autorização da porta para operações de envio é desconhecido.

NdisPortAuthorized

A porta está autorizada para operações de envio.

NdisPortUnauthorized

A porta não está autorizada para operações de envio.

NdisPortReauthorizing

A porta está autorizando novamente para operações de envio.

RcvAuthorizationState

O estado de autorização da porta para operações de recebimento. Ignore esse membro se o membro RcvControlState estiver definido como NdisPortControlStateUncontrolled.

RcvAuthorizationState deve conter um dos seguintes valores:

NdisPortAuthorizationUnknown

O estado de autorização da porta para operações de recebimento é desconhecido.

NdisPortAuthorized

A porta está autorizada para operações de recebimento.

NdisPortUnauthorized

A porta não está autorizada para operações de recebimento.

NdisPortReauthorizing

A porta está sendo autorizada novamente para operações de recebimento.

Comentários

A estrutura NDIS_PORT_CHARACTERISTICS especifica as características de uma porta NDIS. Essa estrutura aparece em uma lista de características de porta fornecidas na estrutura NDIS_PORT_ARRAY usada com o OID do OID_GEN_ENUMERATE_PORTS .

Para alocar uma porta NDIS, um driver inicializa uma estrutura NDIS_PORT_CHARACTERISTICS e a passa para a função NdisMAllocatePort . Quando NdisMAllocatePort retorna com êxito, o NDIS define o membro PortNumber de NDIS_PORT_CHARACTERISTICS como o número da porta que o NDIS atribuiu à porta.

O NDIS usa uma lista vinculada de portas em eventos de PnP (Plug and Play de ativação de porta). O NDIS usa a estrutura NDIS_PORT para criar uma lista vinculada de portas e cada estrutura NDIS_PORT contém uma estrutura NDIS_PORT_CHARACTERISTICS .