NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 結構 (ndis.h)

NDIS 迷你埠驅動程式會設定 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 結構,以定義與迷你埠適配卡相關聯的一般迷你埠驅動程序屬性。

語法

typedef struct _NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES {
  NDIS_OBJECT_HEADER               Header;
  ULONG                            Flags;
  NDIS_MEDIUM                      MediaType;
  NDIS_PHYSICAL_MEDIUM             PhysicalMediumType;
  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                            MacOptions;
  ULONG                            SupportedPacketFilters;
  ULONG                            MaxMulticastListSize;
  USHORT                           MacAddressLength;
  UCHAR                            PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                            CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  PNDIS_RECEIVE_SCALE_CAPABILITIES RecvScaleCapabilities;
  NET_IF_ACCESS_TYPE               AccessType;
  NET_IF_DIRECTION_TYPE            DirectionType;
  NET_IF_CONNECTION_TYPE           ConnectionType;
  NET_IFTYPE                       IfType;
  BOOLEAN                          IfConnectorPresent;
  ULONG                            SupportedStatistics;
  ULONG                            SupportedPauseFunctions;
  ULONG                            DataBackFillSize;
  ULONG                            ContextBackFillSize;
  PNDIS_OID                        SupportedOidList;
  ULONG                            SupportedOidListLength;
  ULONG                            AutoNegotiationFlags;
  PNDIS_PM_CAPABILITIES            PowerManagementCapabilitiesEx;
} NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES;

成員

Header

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 結構的NDIS_OBJECT_HEADER結構。 設定 Header 指定要NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES之結構的 Type 成員。

若要指出 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 結構的版本,請將 Revision 成員設定為下列其中一個值:

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

已新增 NDIS 6.2 的 PowerManagementCapabilitiesEx 成員。

Size 成員設定為 NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1

NDIS 6.0 和 NDIS 6,1 的原始版本。

Size 成員設定為 NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1

Flags

保留給 NDIS。

MediaType

迷你埠配接器支援的 NdisMediumXxx 類型。 如需詳細資訊,請參閱 NDIS_MEDIUM

PhysicalMediumType

迷你埠配接器的實體中型類型。 如需詳細資訊,請參閱 OID_GEN_PHYSICAL_MEDIUM

MtuSize

MTU) 大小的最大傳輸單位 (。 如需詳細資訊,請參閱 OID_GEN_MAXIMUM_FRAME_SIZE

MaxXmitLinkSpeed

適配卡每秒以位為單位的最大傳輸連結速度。 如需詳細資訊,請參閱 OID_GEN_MAX_LINK_SPEED

XmitLinkSpeed

配接器目前的傳輸連結速度,以每秒位為單位。 如需詳細資訊,請參閱 OID_GEN_LINK_SPEED_EX

MaxRcvLinkSpeed

適配卡每秒以位為單位的最大接收連結速度。 如需詳細資訊,請參閱 OID_GEN_MAX_LINK_SPEED

RcvLinkSpeed

適配卡目前的接收連結速度,每秒以位為單位。 如需詳細資訊,請參閱 OID_GEN_LINK_SPEED_EX

MediaConnectState

迷你埠適配卡的媒體連線狀態。 如需相關資訊,請參閱 OID_GEN_MEDIA_CONNECT_STATUS_EX

MediaDuplexState

迷你埠適配卡的媒體雙工狀態。 如需詳細資訊,請參閱 OID_GEN_MEDIA_DUPLEX_STATE

LookaheadSize

迷你埠配接器的外觀大小。 如需詳細資訊,請參閱 OID_GEN_CURRENT_LOOKAHEAD

PowerManagementCapabilities

迷你埠配接器的 隨插即用 (PnP) 功能。 如需 PnP 功能的詳細資訊,請參閱 OID_PNP_CAPABILITIES。 如果迷你埠配接器不是電源管理感知,迷你埠驅動程序應該將 PowerManagementCapabilities 設定為 NULL。 NDIS 6.20 和更新版本的驅動程序必須改用 PowerManagementCapabilitiesEx 成員。

MacOptions

迷你埠適配卡的 MAC 選項。 如需詳細資訊,請參閱 OID_GEN_MAC_OPTIONS

SupportedPacketFilters

迷你埠配接器的封包篩選旗標。

MaxMulticastListSize

迷你埠配接器的多播位址清單大小。 如需相關資訊,請參閱 OID_802_3_MAXIMUM_LIST_SIZE

MacAddressLength

MAC 位址長度,以位元組為單位。 MAC 位址長度專屬於媒體類型。

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

永久 MAC 位址。 例如, OID_802_3_PERMANENT_ADDRESS OID 會指定 IEEE 802.3 驅動程式的永久 MAC 位址。

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

目前的 MAC 位址。 例如, OID_802_3_CURRENT_ADDRESS OID 會指定 IEEE 802.3 驅動程式目前的 MAC 位址。

RecvScaleCapabilities

接收端調整 (RSS) NIC 的功能。 如果迷你埠配接器不支援 RSS 功能,請將 RecvScaleCapabilities 設定為 NULL。 如需 RSS 的詳細資訊,請參閱 OID_GEN_RECEIVE_SCALE_CAPABILITIES

AccessType

NET_IF_ACCESS_TYPE NDIS 網路介面存取類型。

DirectionType

NET_IF_DIRECTION_TYPE NDIS 網路介面方向類型。

ConnectionType

NET_IF_CONNECTION_TYPE NDIS 網路介面連線類型。

IfType

因特網指派號碼授權單位 (IANA) 介面類型。 例如,IF_TYPE_ETHERNET_CSMACD (6) 是指派給任何乙太網路類似介面的 IfType 值。 如需介面類型的清單,請參閱 NDIS 介面類型

IfConnectorPresent

布爾值,指出連接器是否存在。 如果有實體配接器,請將此值設定為 TRUE

SupportedStatistics

支援的統計數據。

注意 NDIS 6.0 驅動程式必須支援所有統計數據,而且必須在查詢驅動程式以取得 OID_GEN_STATISTICS時回報這些統計數據。
 
此值是下列旗標的位 OR:

NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED

ifHCInUcastPkts 成員中的數據有效。

NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED

NDIS_STATISTICS_INFO ifHCInMulticastPkts 成員中的數據有效。

NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED

NDIS_STATISTICS_INFO ifHCInBroadcastPkts 成員中的數據有效。

NDIS_STATISTICS_BYTES_RCV_SUPPORTED

NDIS_STATISTICS_INFO ifHCInOctets 成員中的數據有效。

NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED

NDIS_STATISTICS_INFO ifInDiscards 成員中的數據有效。

NDIS_STATISTICS_RCV_ERROR_SUPPORTED

NDIS_STATISTICS_INFO ifInErrors 成員中的數據有效。

NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED

NDIS_STATISTICS_INFO ifHCOutUcastPkts 成員中的數據有效。

NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED

NDIS_STATISTICS_INFO的 ifHCOutMulticastPkts 成員中的數據有效。

NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED

NDIS_STATISTICS_INFO的 ifHCOutBroadcastPkts 成員中的數據有效。

NDIS_STATISTICS_BYTES_XMIT_SUPPORTED

NDIS_STATISTICS_INFO ifHCOutOctets 成員中的數據有效。

NDIS_STATISTICS_XMIT_ERROR_SUPPORTED

ifOutErrors 成員NDIS_STATISTICS_INFO中的數據有效。

NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED

ifOutDiscards 成員NDIS_STATISTICS_INFO中的數據有效。

NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED

NDIS_STATISTICS_INFO ifHCInUcastOctets 成員中的數據有效。

NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED

NDIS_STATISTICS_INFO ifHCInMulticastOctets 成員中的數據有效。

NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED

NDIS_STATISTICS_INFO ifHCInBroadcastOctets 成員中的數據有效。

NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED

NDIS_STATISTICS_INFO ifHCOutUcastOctets 成員中的數據有效。

NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED

ifHCOutMulticastOctets 成員中的數據NDIS_STATISTICS_INFO有效。

NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED

NDIS_STATISTICS_INFO ifHCOutBroadcastOctets 成員中的數據有效。

SupportedPauseFunctions

支援 IEEE 802.3 暫停畫面,做為下列其中一個暫停函式:

NdisPauseFunctionsUnsupported

表示適配卡或連結夥伴不支持暫停畫面。

NdisPauseFunctionsSendOnly

表示適配卡和連結夥伴僅支援將暫停畫面從適配卡傳送至連結夥伴。

NdisPauseFunctionsReceiveOnly

表示適配卡和連結夥伴僅支援將暫停畫面從連結夥伴傳送至配接器

NdisPauseFunctionsSendAndReceive

表示適配卡和連結夥伴支援在 Transint 和接收方向中傳送和接收暫停畫面。

NdisPauseFunctionsUnknown

表示暫停框架交涉正在進行中。 連結夥伴提供的暫停畫面支援未知。

DataBackFillSize

驅動程式所需的數據回填大小,以位元組為單位。

ContextBackFillSize

驅動程式所需的內容回填大小,以位元組為單位。

SupportedOidList

迷你埠驅動程序支援的 OID 清單。 如需詳細資訊,請參閱 OID_GEN_SUPPORTED_LIST

SupportedOidListLength

SupportedOidList 上 OID 清單的大小,以位元組為單位。

AutoNegotiationFlags

迷你埠配接器的自動交涉設定。 此成員是從下列旗標的位 OR 建立:

配接器已與連結夥伴自動交涉傳輸連結速度。

配接器已自動交涉接收連結速度與連結夥伴。

適配卡已自動與連結夥伴交涉雙工狀態。

配接器已自動交涉連結夥伴的暫停函式。

PowerManagementCapabilitiesEx

NDIS_PM_CAPABILITIES 結構的指標。 此結構會指定迷你埠適配卡的電源管理功能。 NDIS 6.20 和更新版本的驅動程式是必要成員。

備註

迷你埠驅動程式會將指標傳遞至 的 MiniportAttributes 參數中的NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES結構 NdisMSetMiniportAttributes 函式。 迷你埠驅動程式會在初始化期間從其MiniportInitializeEx函式呼叫 NdisMSetMiniportAttributes。 迷你埠驅動程序應該在 中設定註冊屬性之後設定這些屬性 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 結構和設定任何其他屬性之前。 設定這些屬性是必要的。

規格需求

需求
最低支援的用戶端 NDIS 6.0 和更新版本支援。
標頭 ndis.h (包含 Ndis.h)

另請參閱

MiniportInitializeEx

NDIS_MEDIUM

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES

NDIS_OBJECT_HEADER

NDIS_PM_CAPABILITIES

NDIS_STATISTICS_INFO

NET_IF_ACCESS_TYPE

NET_IF_CONNECTION_TYPE

NET_IF_DIRECTION_TYPE

NdisMSetMiniportAttributes

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_STATISTICS

OID_GEN_SUPPORTED_LIST

OID_PNP_CAPABILITIES