estrutura NDIS_BIND_PARAMETERS (ndis.h)
O NDIS inicializa uma estrutura NDIS_BIND_PARAMETERS com informações que definem as características de uma associação e a transmite para um driver de protocolo.
Sintaxe
typedef struct _NDIS_BIND_PARAMETERS {
NDIS_OBJECT_HEADER Header;
PNDIS_STRING ProtocolSection;
PNDIS_STRING AdapterName;
PDEVICE_OBJECT PhysicalDeviceObject;
NDIS_MEDIUM MediaType;
ULONG MtuSize;
ULONG64 MaxXmitLinkSpeed;
ULONG64 XmitLinkSpeed;
ULONG64 MaxRcvLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG LookaheadSize;
PNDIS_PNP_CAPABILITIES PowerManagementCapabilities;
ULONG SupportedPacketFilters;
ULONG MaxMulticastListSize;
USHORT MacAddressLength;
UCHAR CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
PNDIS_RECEIVE_SCALE_CAPABILITIES RcvScaleCapabilities;
NET_LUID BoundIfNetluid;
NET_IFINDEX BoundIfIndex;
NET_LUID LowestIfNetluid;
NET_IFINDEX LowestIfIndex;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
NET_IF_CONNECTION_TYPE ConnectionType;
NET_IFTYPE IfType;
BOOLEAN IfConnectorPresent;
PNDIS_PORT ActivePorts;
ULONG DataBackFillSize;
ULONG ContextBackFillSize;
ULONG MacOptions;
NET_IF_COMPARTMENT_ID CompartmentId;
PNDIS_OFFLOAD DefaultOffloadConfiguration;
PNDIS_TCP_CONNECTION_OFFLOAD TcpConnectionOffloadCapabilities;
PNDIS_STRING BoundAdapterName;
PNDIS_HD_SPLIT_CURRENT_CONFIG HDSplitCurrentConfig;
PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
PNDIS_PM_CAPABILITIES PowerManagementCapabilitiesEx;
PNDIS_NIC_SWITCH_CAPABILITIES NicSwitchCapabilities;
BOOLEAN NDKEnabled;
PNDIS_NDK_CAPABILITIES NDKCapabilities;
PNDIS_SRIOV_CAPABILITIES SriovCapabilities;
PNDIS_NIC_SWITCH_INFO_ARRAY NicSwitchArray;
} NDIS_BIND_PARAMETERS, *PNDIS_BIND_PARAMETERS;
Membros
Header
A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_BIND_PARAMETERS . O NDIS define o membro Type da estrutura especificada por Header para NDIS_OBJECT_TYPE_BIND_PARAMETERS.
Para indicar a versão da estrutura NDIS_BIND_PARAMETERS, o NDIS define o membro Revision como um dos seguintes valores:
NDIS_BIND_PARAMETERS_REVISION_4
Vários membros foram adicionados para o NDIS 6.30.
O NDIS define o membro Size como NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4.
NDIS_BIND_PARAMETERS_REVISION_3
Os membros ReceiveFilterCapabilities, PowerManagementCapabilitiesEx e NicSwitchCapabilities foram adicionados para o NDIS 6.20.
O NDIS define o membro Size como NDIS_SIZEOF_BIND_PARAMETERS_REVISION_3.
NDIS_BIND_PARAMETERS_REVISION_2
Adicionado o membro HDSplitCurrentConfig para o NDIS 6.1.
O NDIS define o membro Size como NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2.
NDIS_BIND_PARAMETERS_REVISION_1
Versão original do NDIS 6.0.
O NDIS define o membro Size como NDIS_SIZEOF_BIND_PARAMETERS_REVISION_1.
ProtocolSection
Um ponteiro para uma cadeia de caracteres Unicode que contém um caminho do Registro. O caminho começa da chave de serviço do driver de protocolo e continua na hierarquia do Registro até o nome do adaptador de miniporta (por exemplo, Tcpip\Parameters\Adapters\<miniport adapter name>). O nome do adaptador de miniporta é o nome do adaptador de miniporta inferior na pilha do driver. Se houver um driver intermediário MUX na pilha, o adaptador de miniporto inferior será um miniporto virtual. Caso contrário, o adaptador de miniporta inferior é um adaptador de miniporta para um dispositivo físico.
O driver de protocolo pode usar esse caminho do Registro para ler parâmetros de configuração específicos para a associação entre o driver e o adaptador de miniporta subjacente.
AdapterName
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do adaptador de miniporto subjacente ao qual ProtocolBindAdapterEx deve ser associado.
PhysicalDeviceObject
O objeto de dispositivo físico para o adaptador de miniporto subjacente.
MediaType
O tipo NdisMediumXxx ao qual o adaptador de miniporto subjacente dá suporte. Para obter mais informações sobre os tipos NdisMediumXxx , consulte NDIS_MEDIUM.
MtuSize
O tamanho máximo da MTU (unidade de transferência). Para obter mais informações, consulte OID_GEN_MAXIMUM_FRAME_SIZE.
MaxXmitLinkSpeed
A velocidade máxima do link de transmissão do adaptador subjacente em bits por segundo. Para obter mais informações, consulte OID_GEN_MAX_LINK_SPEED.
XmitLinkSpeed
A velocidade atual do link de transmissão do adaptador subjacente em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.
MaxRcvLinkSpeed
A velocidade máxima do link de recebimento do adaptador subjacente em bits por segundo. Para obter mais informações, consulte OID_GEN_MAX_LINK_SPEED.
RcvLinkSpeed
A velocidade de link de recebimento atual do adaptador subjacente em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.
MediaConnectState
O estado de conexão de mídia para o adaptador de miniporta subjacente. Para obter mais informações, consulte OID_GEN_MEDIA_CONNECT_STATUS_EX.
MediaDuplexState
O estado duplex de mídia para o adaptador de miniporto subjacente. Para obter mais informações, consulte OID_GEN_MEDIA_DUPLEX_STATE.
LookaheadSize
O tamanho do lookahead para o adaptador de miniporta subjacente. Para obter mais informações, consulte OID_GEN_CURRENT_LOOKAHEAD.
PowerManagementCapabilities
A Plug and Play funcionalidades do adaptador de miniporta subjacente. Para obter mais informações, consulte OID_PNP_CAPABILITIES. Drivers NDIS 6.20 e posteriores devem usar o membro PowerManagementCapabilitiesEx .
SupportedPacketFilters
Um conjunto de sinalizadores que identificam os tipos de pacotes de rede que o adaptador de miniporto subjacente pode filtrar.
MaxMulticastListSize
O tamanho da lista de endereços multicast para o adaptador de miniporta subjacente. Para obter mais informações, consulte OID_802_3_MAXIMUM_LIST_SIZE.
MacAddressLength
O comprimento do endereço MAC, em bytes. O comprimento do endereço MAC é específico para o tipo de mídia.
CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]
O endereço MAC atual. Por exemplo, o OID_802_3_CURRENT_ADDRESS OID especifica o endereço MAC atual para drivers IEEE 802.3.
PhysicalMediumType
O tipo médio físico para o adaptador de miniporta. Para obter mais informações, consulte OID_GEN_PHYSICAL_MEDIUM.
RcvScaleCapabilities
Os recursos de RSS (dimensionamento lateral de recebimento) da NIC. Para obter mais informações, consulte OID_GEN_RECEIVE_SCALE_CAPABILITIES.
BoundIfNetluid
O NDIS NET_LUID valor, que também é o nome do adaptador de rede ( ifName no RFC 2863), da interface de nível mais alto que é empilhada no adaptador de miniporta. Ou seja, se houver miniportos virtuais ou módulos de filtro instalados no adaptador de miniporta, esse será o valor NET_LUID do módulo de filtro ou miniporta virtual de nível mais alto.
BoundIfIndex
O índice da interface de rede NDIS da interface de nível mais alto que está empilhada no adaptador de miniporta. Ou seja, se houver miniportos virtuais ou módulos de filtro instalados no adaptador de miniporto, esse será o ifIndex do módulo de miniporto virtual ou filtro de nível mais alto.
LowestIfNetluid
O NDIS NET_LUID valor, que também é o nome do adaptador de rede ( ifName no RFC 2863), da interface de nível mais baixo em uma associação. Ou seja, o adaptador de rede NDIS do adaptador de miniporta na parte inferior de uma pilha de filtros.
LowestIfIndex
O índice da interface de rede NDIS da interface de nível mais baixo em uma associação. Ou seja, o adaptador de rede NDIS do adaptador de miniporta na parte inferior de uma pilha de filtros.
AccessType
Um NET_IF_ACCESS_TYPE tipo de acesso de adaptador de rede NDIS.
DirectionType
Um NET_IF_DIRECTION_TYPE tipo de direção de interface de rede NDIS.
ConnectionType
O tipo de conexão do adaptador de rede NDIS. Use NET_IF_CONNECTION_DEDICATED para um adaptador Ethernet típico. Os seguintes valores são válidos:
NET_IF_CONNECTION_DEDICATED
Especifica o tipo de conexão dedicado. A conexão aparece automaticamente quando o sentido de mídia é TRUE. Por exemplo, uma conexão Ethernet é dedicada.
NET_IF_CONNECTION_PASSIVE
Especifica o tipo de conexão passiva. A outra extremidade deve abrir a conexão com a estação local. Por exemplo, a interface RAS é passiva.
NET_IF_CONNECTION_DEMAND
Especifica o tipo de conexão demand-dial. Uma conexão demand-dial aparece em resposta a uma ação local, por exemplo, enviar um pacote.
IfType
O tipo de interface IANA (Internet Assigned Numbers Authority). Por exemplo, IF_TYPE_ETHERNET_CSMACD (6) é o valor de IfType atribuído a qualquer interface semelhante à Ethernet. Para obter uma lista se tipos de interface, consulte Tipos de interface NDIS.
IfConnectorPresent
Um valor booliano que indica se um conector está presente. O NDIS define esse valor como TRUE se houver um adaptador físico.
ActivePorts
A ser determinado.
DataBackFillSize
O tamanho do backfill de dados necessário, em bytes, da pilha de driver subjacente.
ContextBackFillSize
O tamanho de backfill de contexto necessário, em bytes, da pilha de driver subjacente.
MacOptions
As opções mac para o adaptador de miniporto. Para obter mais informações, consulte OID_GEN_MAC_OPTIONS.
CompartmentId
O compartimento ao qual a interface subjacente pertence ou um dos seguintes valores:
NET_IF_COMPARTMENT_ID_UNSPECIFIED
Especifica que o identificador do compartimento não é usado ou especificado.
NET_IF_COMPARTMENT_ID_PRIMARY
Especifica o identificador do compartimento padrão. Provedores de interface de terceiros sempre devem especificar NET_IF_COMPARTMENT_ID_PRIMARY. Todos os outros valores são reservados para uso interno da Microsoft.
DefaultOffloadConfiguration
Um ponteiro para uma estrutura NDIS_OFFLOAD . Essa estrutura especifica os recursos para um adaptador de miniporta com capacidade de descarregamento de tarefas. Para obter mais informações, consulte OID_TCP_OFFLOAD_CURRENT_CONFIG.
TcpConnectionOffloadCapabilities
Um ponteiro para um NDIS_TCP_CONNECTION_OFFLOAD estrutura que indica os recursos de descarregamento atuais fornecidos pelo adaptador de miniporto subjacente.
BoundAdapterName
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do adaptador de miniporto de nível mais alto que está empilhado no adaptador de miniporto subjacente. Ou seja, se houver miniportos virtuais de driver intermediário de filtro instalados no adaptador de miniporto, esse membro será o nome do miniporto virtual do driver intermediário de filtro de nível mais alto.
HDSplitCurrentConfig
Um ponteiro para um NDIS_HD_SPLIT_CURRENT_CONFIG estrutura. Essa estrutura especifica a configuração atual de divisão de dados de cabeçalho do adaptador de miniporto subjacente. Esse valor poderá ser NULL se o adaptador de miniporta não der suporte à divisão de dados de cabeçalho.
ReceiveFilterCapabilities
Um ponteiro para um NDIS_RECEIVE_FILTER_CAPABILITIES estrutura. Essa estrutura especifica os recursos genéricos de filtragem que estão atualmente habilitados no adaptador de miniporto subjacente. Esse valor poderá ser NULL se o adaptador de miniporto não der suporte à filtragem de recebimento.
PowerManagementCapabilitiesEx
Um ponteiro para uma estrutura NDIS_PM_CAPABILITIES . Essa estrutura especifica os recursos de gerenciamento de energia do adaptador de miniporta. Esse membro é obrigatório para drivers NDIS 6.20 e posteriores.
NicSwitchCapabilities
Um ponteiro para um NDIS_NIC_SWITCH_CAPABILITIES estrutura. Essa estrutura especifica os recursos de comutador NIC do adaptador de miniporta subjacente. Esse valor poderá ser NULL se o adaptador de miniporta não der suporte a recursos de comutador NIC.
NDKEnabled
O NDIS define esse valor como TRUE se a NDKPI (interface do provedor de kernel direto de rede) estiver habilitada atualmente no adaptador de miniporta subjacente.
NDKCapabilities
Um ponteiro para uma estrutura NDIS_NDK_CAPABILITIES . Essa estrutura especifica os recursos do NDKPI que estão atualmente habilitados no adaptador de miniporto subjacente. Esse valor poderá ser NULL se o adaptador de miniporta não der suporte a NDKPI.
SriovCapabilities
Um ponteiro para uma estrutura NDIS_SRIOV_CAPABILITIES . Essa estrutura especifica os recursos de SR-IOV (virtualização de E/S de raiz única) que estão atualmente habilitados no adaptador de miniporto subjacente. Esse valor poderá ser NULL se o adaptador de miniporta não der suporte a recursos SR-IOV.
NicSwitchArray
Um ponteiro para uma estrutura NDIS_NIC_SWITCH_INFO_ARRAY . Essa matriz enumera as opções nic que foram criadas no adaptador de miniporto. As opções NIC só poderão ser criadas se o SR-IOV tiver suporte e habilitado no adaptador.
Comentários
O NDIS passa um ponteiro para uma estrutura NDIS_BIND_PARAMETERS no parâmetro BindParameters do Função ProtocolBindAdapterEx .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Cabeçalho | ndis.h (inclua Ndis.h) |
Confira também
NDIS_RECEIVE_FILTER_CAPABILITIESOID_GEN_MEDIA_CONNECT_STATUS_EX
OID_GEN_RECEIVE_SCALE_CAPABILITIESComentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de