Compartilhar via


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.

Nota Começando com Windows Server 2012, o Windows dá suporte apenas à opção NIC padrão no adaptador de miniporto. Portanto, essa matriz pode conter apenas um elemento.
 

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_HD_SPLIT_CURRENT_CONFIG

NDIS_MEDIUM

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OBJECT_HEADER

NDIS_OFFLOAD

NDIS_PM_CAPABILITIES

NDIS_RECEIVE_FILTER_CAPABILITIES

NDIS_SRIOV_CAPABILITIES

NDIS_TCP_CONNECTION_OFFLOAD

NET_IF_ACCESS_TYPE

NET_IF_DIRECTION_TYPE

NET_LUID

OID_802_3_CURRENT_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_PERMANENT_ADDRESS

OID_GEN_CURRENT_LOOKAHEAD

OID_GEN_LINK_SPEED_EX

OID_GEN_MAC_OPTIONS

OID_GEN_MAXIMUM_FRAME_SIZE

OID_GEN_MAX_LINK_SPEED

OID_GEN_MEDIA_CONNECT_STATUS_EX

OID_GEN_MEDIA_DUPLEX_STATE

OID_GEN_PHYSICAL_MEDIUM

OID_GEN_RECEIVE_SCALE_CAPABILITIES

OID_PNP_CAPABILITIES

OID_TCP_OFFLOAD_CURRENT_CONFIG

ProtocolBindAdapterEx