estrutura NDIS_FILTER_ATTACH_PARAMETERS (ndis.h)
A estrutura NDIS_FILTER_ATTACH_PARAMETERS define os parâmetros de inicialização para o módulo de filtro.
Sintaxe
typedef struct _NDIS_FILTER_ATTACH_PARAMETERS {
NDIS_OBJECT_HEADER Header;
NET_IFINDEX IfIndex;
NET_LUID NetLuid;
PNDIS_STRING FilterModuleGuidName;
NET_IFINDEX BaseMiniportIfIndex;
PNDIS_STRING BaseMiniportInstanceName;
PNDIS_STRING BaseMiniportName;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_MEDIUM MiniportMediaType;
NDIS_PHYSICAL_MEDIUM MiniportPhysicalMediaType;
NDIS_HANDLE MiniportMediaSpecificAttributes;
PNDIS_OFFLOAD DefaultOffloadConfiguration;
USHORT MacAddressLength;
UCHAR CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
NET_LUID BaseMiniportNetLuid;
NET_IFINDEX LowerIfIndex;
NET_LUID LowerIfNetLuid;
ULONG Flags;
PNDIS_HD_SPLIT_CURRENT_CONFIG HDSplitCurrentConfig;
PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
PDEVICE_OBJECT MiniportPhysicalDeviceObject;
PNDIS_NIC_SWITCH_CAPABILITIES NicSwitchCapabilities;
BOOLEAN BaseMiniportIfConnectorPresent;
PNDIS_SRIOV_CAPABILITIES SriovCapabilities;
PNDIS_NIC_SWITCH_INFO_ARRAY NicSwitchArray;
} NDIS_FILTER_ATTACH_PARAMETERS, *PNDIS_FILTER_ATTACH_PARAMETERS;
Membros
Header
A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_FILTER_ATTACH_PARAMETERS . O NDIS define o membro Type da estrutura especificada por Header para NDIS_OBJECT_TYPE_FILTER_ATTACH_PARAMETERS.
Para indicar a versão da estrutura NDIS_FILTER_ATTACH_PARAMETERS , o NDIS define o membro Revision como um dos seguintes valores:
NDIS_FILTER_ATTACH__PARAMETERS_REVISION_4
Vários membros foram adicionados para o NDIS 6.30.
O NDIS define o membro Size como NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_4.
NDIS_FILTER_ATTACH_PARAMETERS_REVISION_3
Os membros ReceiveFilterCapabilities, MiniportPhysicalDeviceObject e NicSwitchCapabilities foram adicionados ao NDIS 6.20.
O NDIS define o membro Size como NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_3.
NDIS_FILTER_ATTACH_PARAMETERS_REVISION_2
Adicionado o membro HDSplitCurrentConfig para o NDIS 6.1.
O NDIS define o membro Size como NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_2.
NDIS_FILTER_ATTACH_PARAMETERS_REVISION_1
Versão original do NDIS 6.0.
O NDIS define o membro Size como NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_1.
IfIndex
O índice da interface NDIS do módulo de filtro que o NDIS está anexando à pilha de driver.
NetLuid
O adaptador de rede NDIS NET_LUID valor para o módulo de filtro que o NDIS está anexando à pilha de driver. O NET_LUID é equivalente ao nome da interface (ifName no RFC 2863 ).
FilterModuleGuidName
O nome guid do módulo de filtro que o NDIS está anexando.
BaseMiniportIfIndex
O índice da interface de rede NDIS do adaptador de miniporta base. Ou seja, se houver miniportos virtuais ou módulos de filtro instalados em um adaptador de miniporto físico, o valor desse membro será o índice de interface do adaptador de miniporto físico ou um miniporto virtual do driver intermediário MUX de nível mais alto.
BaseMiniportInstanceName
Um ponteiro para um valor de tipo NDIS_STRING que contém uma cadeia de caracteres Unicode contada. Essa cadeia de caracteres especifica o nome amigável da interface para o adaptador de miniporto base. Para o Windows 2000 e versões posteriores, o NDIS define o tipo NDIS_STRING como um tipo de UNICODE_STRING .
BaseMiniportName
O nome do adaptador de miniporta base.
MediaConnectState
O NET_IF_MEDIA_CONNECT_STATE tipo de estado de conexão.
MediaDuplexState
O estado duplex de mídia para o adaptador de miniporto subjacente. Para obter mais informações, consulte OID_GEN_MEDIA_DUPLEX_STATE.
XmitLinkSpeed
A velocidade de link de transmissão atual do adaptador de miniporta subjacente em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.
RcvLinkSpeed
A velocidade do link de recebimento atual do adaptador de miniporta subjacente em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.
MiniportMediaType
O tipo NdisMediumXxx ao qual o adaptador de miniporto base subjacente dá suporte. Para obter mais informações, consulte NDIS_MEDIUM.
MiniportPhysicalMediaType
O tipo médio físico para o adaptador de miniporta base subjacente. Para obter mais informações, consulte OID_GEN_PHYSICAL_MEDIUM.
MiniportMediaSpecificAttributes
Um ponteiro para uma estrutura NDIS_OBJECT_HEADER que identifica uma estrutura que contém atributos específicos de mídia de miniporto ou NULL se não houver esses atributos. O membro Type da estrutura NDIS_OBJECT_HEADER identifica o tipo da estrutura de atributos. Por exemplo, se o tipo de mídia do adaptador de miniporta subjacente for NdisMediumNative802_11, o membro Type deverá ser NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES e o membro MiniportMediaSpecificAttributes apontará para um NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES estrutura.
DefaultOffloadConfiguration
Um ponteiro para uma estrutura NDIS_OFFLOAD que define atributos de descarregamento de tarefa. O driver de filtro deve examinar esses atributos para obter os recursos de descarregamento de tarefas dos drivers subjacentes. O driver de filtro deve modificar esses atributos, se necessário, para refletir as alterações no suporte de descarregamento de tarefa que ele requer.
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.
BaseMiniportNetLuid
O adaptador de rede NDIS NET_LUID do adaptador de miniporta base. Ou seja, se houver miniportos virtuais ou módulos de filtro instalados em um adaptador de miniporto físico, o valor desse membro será o NET_LUID do adaptador de miniporto físico ou um miniporto virtual do driver intermediário MUX de nível mais alto.
LowerIfIndex
O índice da interface de rede NDIS da interface logo abaixo do módulo de filtro atual. Ou seja, se houver módulos de filtro ou NDIS 5. x filtrar drivers intermediários instalados em um adaptador de miniporto físico ou no driver intermediário MUX de nível mais alto, esse membro contém o índice de interface da interface do módulo de filtro ou a interface de driver intermediário de filtro que está logo abaixo do módulo de filtro atual. Se não houver nenhum módulo de filtro ou interfaces de driver intermediário de filtro instaladas sobre o adaptador de miniporto físico ou o driver intermediário MUX de nível mais alto, esse membro conterá o índice de interface do adaptador de miniporto físico subjacente ou o miniporto virtual de driver intermediário MUX de nível mais alto.
LowerIfNetLuid
O adaptador de rede NDIS NET_LUID valor da interface logo abaixo do módulo de filtro atual. Ou seja, se houver módulos de filtro ou NDIS 5. x filtrar drivers intermediários instalados em um adaptador de miniporto físico ou no driver intermediário MUX de nível mais alto, esse membro contém a interface de rede NET_LUID da interface do módulo de filtro ou a interface de driver intermediário de filtro que está logo abaixo do módulo de filtro atual. Se não houver nenhum módulo de filtro ou interfaces de driver intermediário de filtro instaladas no adaptador de miniporto físico ou no driver intermediário MUX de nível mais alto, esse membro conterá a interface de rede NET_LUID do adaptador de miniporto físico subjacente ou o miniporto virtual de driver intermediário MUX de nível mais alto.
Flags
Reservado para uso futuro.
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.
MiniportPhysicalDeviceObject
Um ponteiro para uma estrutura DEVICE_OBJECT . Essa estrutura representa o dispositivo físico para o adaptador de miniporto subjacente.
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.
BaseMiniportIfConnectorPresent
Um valor booliano que, se definido como TRUE, indica se um conector de adaptador de rede (se) está presente no adaptador de rede subjacente. Esse valor deve ser definido como TRUE para um adaptador físico.
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.
Para obter mais informações, consulte Virtualização de E/S de raiz única (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
Para definir parâmetros de anexação do módulo de filtro, o NDIS passa um ponteiro para uma estrutura NDIS_FILTER_ATTACH_PARAMETERS para a função FilterAttach .
Os drivers de filtro devem evitar a emissão de consultas OID desnecessárias. Em vez disso, use as informações em NDIS_FILTER_ATTACH_PARAMETERS, quando disponível, para obter informações sobre drivers subjacentes.
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_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES NDIS_RECEIVE_FILTER_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