estrutura NDIS_PORT_CHARACTERISTICS (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 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.
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 .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Cabeçalho | ntddndis.h (inclua Ndis.h) |