Compartilhar via


NDIS_PORT_CHARACTERISTICS estrutura (ntddndis.h)

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 tipo da estrutura que de Cabeçalho especifica para NDIS_OBJECT_TYPE_DEFAULT, o membro de Revisão de para NDIS_PORT_CHARACTERISTICS_REVISION_1 e o membro tamanho para 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 miniporto pode usar esse sinalizador para solicitar que o NDIS use as configurações de estado de autenticação padrão para as portas que ele aloca e ativa. Se o driver de miniporto 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.

Observação Esse valor tem suporte apenas no NDIS 6.30 e posterior.
 

MediaConnectState

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

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 tipo de direção de interface de rede NDIS NET_IF_DIRECTION_TYPE.

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 descontrolado 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 as 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 novamente autorizada para operações de recebimento.

Observações

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 que é usada com o OID OID_GEN_ENUMERATE_PORTS.

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

O NDIS usa uma lista vinculada de portas em eventos 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.

Requisitos

Requisito Valor
de cliente com suporte mínimo Com suporte no NDIS 6.0 e posterior.
cabeçalho ntddndis.h (inclua Ndis.h)

Consulte também

portas NDIS

NDIS_OBJECT_HEADER

NDIS_PORT

NDIS_PORT_ARRAY

NET_IF_DIRECTION_TYPE

NdisMAllocatePort

OID_GEN_ENUMERATE_PORTS

OID_GEN_MEDIA_CONNECT_STATUS_EX

tipos de portas NDIS