NDIS_INTERFACE_INFORMATION 結構 (ifdef.h)
NDIS_INTERFACE_INFORMATION 結構提供 OID_GEN_INTERFACE_INFO OID 網路介面的相關信息。
語法
typedef struct _NDIS_INTERFACE_INFORMATION {
NET_IF_OPER_STATUS ifOperStatus;
ULONG ifOperStatusFlags;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG ifMtu;
BOOLEAN ifPromiscuousMode;
BOOLEAN ifDeviceWakeUpEnable;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
ULONG64 ifLastChange;
ULONG64 ifCounterDiscontinuityTime;
ULONG64 ifInUnknownProtos;
ULONG64 ifInDiscards;
ULONG64 ifInErrors;
ULONG64 ifHCInOctets;
ULONG64 ifHCInUcastPkts;
ULONG64 ifHCInMulticastPkts;
ULONG64 ifHCInBroadcastPkts;
ULONG64 ifHCOutOctets;
ULONG64 ifHCOutUcastPkts;
ULONG64 ifHCOutMulticastPkts;
ULONG64 ifHCOutBroadcastPkts;
ULONG64 ifOutErrors;
ULONG64 ifOutDiscards;
ULONG64 ifHCInUcastOctets;
ULONG64 ifHCInMulticastOctets;
ULONG64 ifHCInBroadcastOctets;
ULONG64 ifHCOutUcastOctets;
ULONG64 ifHCOutMulticastOctets;
ULONG64 ifHCOutBroadcastOctets;
NET_IF_COMPARTMENT_ID CompartmentId;
ULONG SupportedStatistics;
} NDIS_INTERFACE_INFORMATION, *PNDIS_INTERFACE_INFORMATION;
成員
ifOperStatus
介面的操作狀態。 此狀態與 OID_GEN_OPERATIONAL_STATUS OID 傳回的值相同。
ifOperStatusFlags
介面的操作狀態旗標。 此欄位會保留給 NDIS Proxy 介面提供者。 其他介面提供者應將此成員設定為零。
MediaConnectState
NET_IF_MEDIA_CONNECT_STATE連線狀態類型。
MediaDuplexState
介面的媒體雙工狀態。 此狀態與 OID_GEN_MEDIA_DUPLEX_STATE OID 傳回的值相同。
ifMtu
介面的最大傳輸單位 (MTU) 。 此 MTU 與 OID_GEN_MAXIMUM_FRAME_SIZE OID 傳回的值相同。
ifPromiscuousMode
布爾值，如果介面處於寬鬆模式，則為 TRUE ;如果不是，則為 FALSE 。 這個值與 OID_GEN_PROMISCUOUS_MODE OID 查詢傳回的值相同。
ifDeviceWakeUpEnable
布爾值，如果介面支援網路喚醒功能且已啟用此功能，則為 TRUE ;如果不支援，則為 FALSE 。
XmitLinkSpeed
介面的傳輸連結速度每秒以位元組為單位。 這個速度與 OID_GEN_XMIT_LINK_SPEED OID 查詢傳回的值相同。
RcvLinkSpeed
介面的接收連結速度每秒以位元組為單位。 此速度與 OID_GEN_RCV_LINK_SPEED OID 查詢傳回的值相同。
ifLastChange
介面進入其目前作業狀態的時間。 這次與 OID_GEN_LAST_CHANGE OID 查詢傳回的值相同。
ifCounterDiscontinuityTime
介面計數器的最後一個不連續時間。 這次與 OID_GEN_DISCONTINUITY_TIME OID 查詢傳回的值相同。
ifInUnknownProtos
透過介面接收的封包數目，以及因為未知或不支援的通訊協定而捨棄的封包數目。 這個數位與 OID_GEN_UNKNOWN_PROTOS OID 查詢傳回的值相同。
ifInDiscards
即使未偵測到任何錯誤，仍捨棄的輸入封包數目，以防止它們傳遞至較高層通訊協定。 這個數位與 OID_GEN_RCV_DISCARDS OID 查詢傳回的值相同。
ifInErrors
包含錯誤導致無法傳遞至較高層通訊協議的輸入封包數目。 這個數位與 OID_GEN_RCV_ERROR OID 查詢傳回的值相同。
ifHCInOctets
在此介面上收到的位元組總數。 這個數位與 OID_GEN_BYTES_RCV OID 傳回的值相同。
ifHCInUcastPkts
在介面上未發生錯誤的情況下接收的導向封包數目。 這個數位與 OID_GEN_DIRECTED_FRAMES_RCV OID 查詢傳回的值相同。
ifHCInMulticastPkts
介面上未發生錯誤的多播/功能封包數目。 這個數位與 OID_GEN_MULTICAST_FRAMES_RCV OID 查詢傳回的值相同。
ifHCInBroadcastPkts
在介面上未發生錯誤的情況下接收的廣播封包數目。 這個數位與 OID_GEN_BROADCAST_FRAMES_RCV OID 查詢傳回的值相同。
ifHCOutOctets
在介面上未發生錯誤的情況下傳輸的位元元數目。 這個數位與 OID_GEN_BYTES_XMIT OID 查詢傳回的值相同。
ifHCOutUcastPkts
在介面上未發生錯誤的情況下傳輸的導向封包數目。 這個數位與 OID_GEN_DIRECTED_FRAMES_XMIT OID 查詢傳回的值相同。
ifHCOutMulticastPkts
在介面上未發生錯誤的情況下傳輸的多播/功能封包數目。 這個數位與 OID_GEN_MULTICAST_FRAMES_XMIT OID 查詢傳回的值相同。
ifHCOutBroadcastPkts
在介面上未發生錯誤的情況下傳輸的廣播封包數目。 這個數位與 OID_GEN_BROADCAST_FRAMES_XMIT OID 查詢傳回的值相同。
ifOutErrors
介面無法傳輸的封包數目。 這個數位與 OID_GEN_XMIT_ERROR OID 查詢傳回的值相同。
ifOutDiscards
介面捨棄的封包數目。 這個數位與 OID_GEN_XMIT_DISCARDS OID 查詢傳回的值相同。
ifHCInUcastOctets
在未發生錯誤的情況下收到之導向封包中的位元組數目。 這個計數與 OID_GEN_DIRECTED_BYTES_RCV 傳回的值相同。
ifHCInMulticastOctets
多播/功能封包中的位元組數目，這些封包未收到錯誤。 這個計數與 OID_GEN_MULTICAST_BYTES_RCV 傳回的值相同。
ifHCInBroadcastOctets
廣播封包中接收且沒有錯誤的位元元數目。 這個計數與 OID_GEN_BROADCAST_BYTES_RCV 傳回的值相同。
ifHCOutUcastOctets
在未發生錯誤的情況下傳輸的導向封包中的位元元組數目。 這個計數與 OID_GEN_DIRECTED_BYTES_XMIT 傳回的值相同。
ifHCOutMulticastOctets
多播/功能封包中傳輸且沒有錯誤的位元元組數目。 這個計數與 OID_GEN_MULTICAST_BYTES_XMIT 傳回的值相同。
ifHCOutBroadcastOctets
廣播封包中傳輸且沒有錯誤的位元元數目。 這個計數與 OID_GEN_BROADCAST_BYTES_XMIT 傳回的值相同。
CompartmentId
如果介面提供者可以提供介面所屬區間的標識符，則介面所屬的區間。 否則，它應該會傳回NET_IF_COMPARTMENT_ID_UNSPECIFIED。 如果介面提供者針對區間標識碼傳回NET_IF_COMPARTMENT_ID_UNSPECIFIED，NDIS 會傳回此介面的正確區間標識符。
SupportedStatistics
支援的統計數據。 如需詳細資訊，請參閱 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 結構的 SupportedStatistics 成員。
備註
NDIS 介面提供者會填入NDIS_INTERFACE_INFORMATION結構，以回應 OID_GEN_INTERFACE_INFO OID 的查詢。 這個結構包含介面存留期期間變更的資訊。
若要註冊為介面提供者，NDIS 驅動程式會呼叫 NdisIfRegisterProvider 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista 中支援 NDIS 6.0 驅動程式。 |
| 標頭 | ifdef.h (include Ndis.h) |
另請參閱
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES