estrutura NDIS_INTERFACE_INFORMATION (ifdef.h)
A estrutura NDIS_INTERFACE_INFORMATION fornece informações sobre um adaptador de rede para o OID do OID_GEN_INTERFACE_INFO .
Sintaxe
typedef struct _NDIS_INTERFACE_INFORMATION {
NET_IF_OPER_STATUS ifOperStatus;
ULONG ifOperStatusFlags;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG ifMtu;
BOOLEAN ifPromiscuousMode;
BOOLEAN ifDeviceWakeUpEnable;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
ULONG64 ifLastChange;
ULONG64 ifCounterDiscontinuityTime;
ULONG64 ifInUnknownProtos;
ULONG64 ifInDiscards;
ULONG64 ifInErrors;
ULONG64 ifHCInOctets;
ULONG64 ifHCInUcastPkts;
ULONG64 ifHCInMulticastPkts;
ULONG64 ifHCInBroadcastPkts;
ULONG64 ifHCOutOctets;
ULONG64 ifHCOutUcastPkts;
ULONG64 ifHCOutMulticastPkts;
ULONG64 ifHCOutBroadcastPkts;
ULONG64 ifOutErrors;
ULONG64 ifOutDiscards;
ULONG64 ifHCInUcastOctets;
ULONG64 ifHCInMulticastOctets;
ULONG64 ifHCInBroadcastOctets;
ULONG64 ifHCOutUcastOctets;
ULONG64 ifHCOutMulticastOctets;
ULONG64 ifHCOutBroadcastOctets;
NET_IF_COMPARTMENT_ID CompartmentId;
ULONG SupportedStatistics;
} NDIS_INTERFACE_INFORMATION, *PNDIS_INTERFACE_INFORMATION;
Membros
ifOperStatus
O status operacional da interface. Esse status é o mesmo que o valor retornado pelo OID_GEN_OPERATIONAL_STATUS OID.
ifOperStatusFlags
Os sinalizadores de status operacionais da interface. Esse campo é reservado para o provedor de interface de proxy do NDIS. Outros provedores de interface devem definir esse membro como zero.
MediaConnectState
O tipo de estado de conexão NET_IF_MEDIA_CONNECT_STATE.
MediaDuplexState
O estado duplex de mídia da interface. Esse estado é o mesmo que o valor que o OID OID_GEN_MEDIA_DUPLEX_STATE retorna.
ifMtu
A MTU (unidade de transmissão máxima) da interface. Essa MTU é a mesma que o valor retornado pelo OID_GEN_MAXIMUM_FRAME_SIZE OID.
ifPromiscuousMode
Um valor booliano que será TRUE se a interface estiver no modo promíscuo ou FALSE se não estiver. Esse valor é o mesmo que o valor que OID_GEN_PROMISCUOUS_MODE consulta OID retorna.
ifDeviceWakeUpEnable
Um valor booliano que será TRUE se a interface der suporte à funcionalidade wake-on-LAN e a funcionalidade estiver habilitada ou FALSE , se não o fizer.
XmitLinkSpeed
A velocidade do link de transmissão, em bytes por segundo, da interface . Essa velocidade é a mesma que o valor retornado por uma consulta OID OID_GEN_XMIT_LINK_SPEED .
RcvLinkSpeed
A velocidade do link de recebimento, em bytes por segundo, da interface . Essa velocidade é a mesma que o valor retornado por uma consulta OID OID_GEN_RCV_LINK_SPEED .
ifLastChange
A hora em que a interface entrou em seu estado operacional atual. Desta vez é o mesmo que o valor retornado por uma consulta OID OID_GEN_LAST_CHANGE .
ifCounterDiscontinuityTime
A hora da última descontinuidade dos contadores da interface. Desta vez é o mesmo que o valor retornado por uma consulta OID OID_GEN_DISCONTINUITY_TIME .
ifInUnknownProtos
O número de pacotes que foram recebidos por meio da interface e que foram descartados devido a um protocolo desconhecido ou sem suporte. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_UNKNOWN_PROTOS .
ifInDiscards
O número de pacotes de entrada que foram descartados, embora nenhum erro tenha sido detectado para impedir que eles sejam entregues a um protocolo de camada superior. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_RCV_DISCARDS .
ifInErrors
O número de pacotes de entrada que continham erros que os impediam de serem entregues a um protocolo de camada superior. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_RCV_ERROR .
ifHCInOctets
O número total de bytes recebidos nessa interface. Esse número é o mesmo que o valor retornado por um OID OID_GEN_BYTES_RCV .
ifHCInUcastPkts
O número de pacotes direcionados recebidos sem erros na interface. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_DIRECTED_FRAMES_RCV .
ifHCInMulticastPkts
O número de pacotes multicast/funcionais recebidos sem erros na interface. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_MULTICAST_FRAMES_RCV .
ifHCInBroadcastPkts
O número de pacotes de difusão recebidos sem erros na interface. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_BROADCAST_FRAMES_RCV .
ifHCOutOctets
O número de bytes transmitidos sem erros na interface. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_BYTES_XMIT .
ifHCOutUcastPkts
O número de pacotes direcionados que são transmitidos sem erros na interface. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_DIRECTED_FRAMES_XMIT .
ifHCOutMulticastPkts
O número de pacotes multicast/funcionais transmitidos sem erros na interface. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_MULTICAST_FRAMES_XMIT .
ifHCOutBroadcastPkts
O número de pacotes de difusão que são transmitidos sem erros na interface. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_BROADCAST_FRAMES_XMIT .
ifOutErrors
O número de pacotes que a interface não transmite. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_XMIT_ERROR .
ifOutDiscards
O número de pacotes que a interface descarta. Esse número é o mesmo que o valor retornado por uma consulta OID OID_GEN_XMIT_DISCARDS .
ifHCInUcastOctets
O número de bytes em pacotes direcionados recebidos sem erros. Essa contagem é o mesmo valor que OID_GEN_DIRECTED_BYTES_RCV retorna.
ifHCInMulticastOctets
O número de bytes em pacotes multicast/funcionais recebidos sem erros. Essa contagem é o mesmo valor que OID_GEN_MULTICAST_BYTES_RCV retorna.
ifHCInBroadcastOctets
O número de bytes em pacotes de difusão recebidos sem erros. Essa contagem é o mesmo valor que OID_GEN_BROADCAST_BYTES_RCV retorna.
ifHCOutUcastOctets
O número de bytes em pacotes direcionados que são transmitidos sem erros. Essa contagem é o mesmo valor que OID_GEN_DIRECTED_BYTES_XMIT retorna.
ifHCOutMulticastOctets
O número de bytes em pacotes multicast/funcionais transmitidos sem erros. Essa contagem é o mesmo valor que OID_GEN_MULTICAST_BYTES_XMIT retorna.
ifHCOutBroadcastOctets
O número de bytes em pacotes de difusão que são transmitidos sem erros. Essa contagem é o mesmo valor que OID_GEN_BROADCAST_BYTES_XMIT retorna.
CompartmentId
O compartimento ao qual a interface pertence, se o provedor de interface puder fornecer a ID do compartimento ao qual a interface pertence. Caso contrário, ele deverá retornar NET_IF_COMPARTMENT_ID_UNSPECIFIED. Se o provedor de interface retornar NET_IF_COMPARTMENT_ID_UNSPECIFIED para a ID do compartimento, o NDIS retornará a ID do compartimento certo para essa interface.
SupportedStatistics
As estatísticas com suporte. Para obter mais informações, consulte o membro SupportedStatistics da estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .
Comentários
Os provedores de interface NDIS preenchem uma estrutura de NDIS_INTERFACE_INFORMATION em resposta a uma consulta do OID OID_GEN_INTERFACE_INFO . Essa estrutura contém informações que são alteradas durante o tempo de vida da interface.
Para se registrar como um provedor de interface, um driver NDIS chama a função NdisIfRegisterProvider .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte para drivers NDIS 6.0 no Windows Vista. |
| Cabeçalho | ifdef.h (inclua Ndis.h) |
Confira também
Introdução aos drivers de rede
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES