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 結構。 將 標頭 指定為NDIS_OBJECT_TYPE_ DEFAULT、Revision 成員設為 NDIS_PORT_STATE_REVISION_1,並將 Size 成員NDIS_PORT_STATE_REVISION_1設為 NDIS_SIZEOF_PORT_STATE_REVISION_1 的 Type 成員。
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) |