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.
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) |