NDIS_PORT_STATE 結構 (ntddndis.h)
NDIS_PORT_STATE 結構會指定 NDIS 埠的埠狀態資訊。
語法
typedef struct _NDIS_PORT_STATE {
NDIS_OBJECT_HEADER Header;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NET_IF_DIRECTION_TYPE Direction;
NDIS_PORT_CONTROL_STATE SendControlState;
NDIS_PORT_CONTROL_STATE RcvControlState;
NDIS_PORT_AUTHORIZATION_STATE SendAuthorizationState;
NDIS_PORT_AUTHORIZATION_STATE RcvAuthorizationState;
ULONG Flags;
} NDIS_PORT_STATE, *PNDIS_PORT_STATE;
成員
Header
NDIS_PORT_STATE 結構的NDIS_OBJECT_HEADER結構。 將 Header 指定的結構 Type 成員設定為 NDIS_OBJECT_TYPE_ DEFAULT、將 Revision 成員設定為 NDIS_PORT_STATE_REVISION_1，並將 Size 成員設定為 NDIS_SIZEOF_PORT_STATE_REVISION_1。
MediaConnectState
埠的媒體連線狀態。 此狀態與 相同的資訊 OID_GEN_MEDIA_CONNECT_STATUS_EX OID 傳回。
XmitLinkSpeed
埠的傳輸連結速度，每秒以位為單位。 這個成員中的 -1 值表示傳輸連結速度不明。
RcvLinkSpeed
埠的接收連結速度，每秒以位為單位。 這個成員中的 -1 值表示接收連結速度未知。
Direction
NET_IF_DIRECTION_TYPE NDIS 網路介面方向類型。
SendControlState
傳送作業的埠目前控制狀態。 此成員必須包含下列其中一個值：
NdisPortControlStateUnknown
傳送作業的埠控制狀態未知。
NdisPortControlStateControlled
埠處於傳送作業的受控制狀態。 也就是說，埠需要授權。
NdisPortControlStateUncontrolled
埠處於傳送作業的未受控制狀態。 也就是說，埠不需要授權。
RcvControlState
接收作業之埠的目前控制狀態。 此成員必須包含下列其中一個值：
NdisPortControlStateUnknown
接收作業的埠控制狀態未知。
NdisPortControlStateControlled
埠處於接收作業的受控制狀態。 也就是說，埠需要授權。
NdisPortControlStateUncontrolled
埠處於接收作業的未受控制狀態。 也就是說，埠不需要授權。
SendAuthorizationState
傳送作業的埠目前授權狀態。 如果 SendControlState 成員設定為 NdisPortControlStateUncontrolled，請忽略此成員。
SendAuthorizationState 必須包含下列其中一個值：
NdisPortAuthorizationUnknown
傳送作業的埠授權狀態未知。
NdisPortAuthorized
埠已獲得傳送作業的授權。
NdisPortUnauthorized
埠未獲得傳送作業的授權。
NdisPortReauthorizing
埠已重新授權傳送作業。
RcvAuthorizationState
接收作業的埠目前授權狀態。 如果 RcvControlState 成員設定為 NdisPortControlStateUncontrolled，請忽略此成員。
RcvAuthorizationState 必須包含下列其中一個值：
NdisPortAuthorizationUnknown
接收作業的埠授權狀態未知。
NdisPortAuthorized
埠已獲得接收作業的授權。
NdisPortUnauthorized
埠未獲得接收作業的授權。
NdisPortReauthorizing
埠已重新授權接收作業。
Flags
保留給 NDIS。
備註
NDIS_PORT_STATE 結構用於 NDIS_STATUS_PORT_STATE 狀態指示，以指出埠狀態的變更，並用於回應 OID_GEN_PORT_STATE OID 查詢。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
| 標頭 | ntddndis.h (包括 Ndis.h) |