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_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 建立:
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
配接器已與連結夥伴自動交涉傳輸連結速度。
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
配接器已自動交涉接收連結速度與連結夥伴。
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
適配卡已自動與連結夥伴交涉雙工狀態。
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
配接器已自動交涉連結夥伴的暫停函式。
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) |