NDIS_PORT_CHARACTERISTICS 구조체(ntddndis.h)
NDIS_PORT_CHARACTERISTICS 구조체는 NDIS 포트의 특성을 지정합니다. NDIS 포트에 대한 자세한 내용은 NDIS 포트를 참조하세요.
구문
typedef struct _NDIS_PORT_CHARACTERISTICS {
NDIS_OBJECT_HEADER Header;
NDIS_PORT_NUMBER PortNumber;
ULONG Flags;
NDIS_PORT_TYPE Type;
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;
} NDIS_PORT_CHARACTERISTICS, *PNDIS_PORT_CHARACTERISTICS;
멤버
Header
NDIS_PORT_CHARACTERISTICS 구조체의 NDIS_OBJECT_HEADER 구조체입니다. Header에서 지정하는 구조체의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT, Revision 멤버를 NDIS_PORT_CHARACTERISTICS_REVISION_1, Size 멤버를 NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1 설정합니다.
PortNumber
이 NDIS_PORT_CHARACTERISTICS 구조체와 연결된 NDIS 포트의 수입니다. PortNumber 값은 ULONG 데이터 형식이 있고 0부터 0xffffff까지 유효한 NDIS_PORT_NUMBER 값입니다. 여기서 0은 기본 포트에 대해 예약되어 있습니다.
Flags
포트 특성 플래그의 비트 OR 조합이거나 플래그가 설정되지 않은 경우 0입니다. 현재 하나의 플래그가 있습니다.
NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS 플래그가 설정된 경우 NDIS는 인증 상태 설정을 무시하고 대신 기본 인증 상태를 사용합니다. 미니포트 드라이버는 이 플래그를 사용하여 NDIS가 할당하고 활성화하는 포트에 대한 기본 인증 상태 설정을 사용하도록 요청할 수 있습니다. 미니포트 드라이버가 기본 포트를 제어하는 경우 미니포트 드라이버가 기본 포트를 활성화할 때 드라이버는 기본 인증 상태 설정을 사용하여 기본 포트를 활성화하도록 NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS 설정할 수 있습니다.
Type
NDIS 포트의 형식입니다. 자세한 내용은 NDIS 포트 유형을 참조하세요. 이 유형은 다음 값 중 하나일 수 있습니다.
NdisPortTypeUndefined
기본 포트 유형입니다.
NdisPortTypeBridge
시스템에서 사용하도록 예약되었습니다.
NdisPortTypeRasConnection
RAS(원격 액세스 서비스) 연결입니다.
NdisPortType8021xSupplicant
이 호스트 컴퓨터의 액세스 지점과 연결된 원격 무선 스테이션입니다.
NdisPortTypeNdisImPlatform
시스템에서 사용하도록 예약되었습니다.
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
포트는 수신 작업에 대해 제어된 상태이며(즉, 포트에 권한 부여가 필요함) SendAuthorizationState 멤버의 값에 따라 인증 상태가 결정됩니다.
NdisPortControlStateUncontrolled
포트는 수신 작업에 대해 제어되지 않는 상태입니다. 따라서 인증은 이 포트에 적용되지 않습니다.
SendAuthorizationState
송신 작업에 대한 포트의 권한 부여 상태입니다. SendControlState 멤버가 NdisPortControlStateUncontrolled로 설정된 경우 이 멤버를 무시합니다.
SendAuthorizationState 는 다음 값 중 하나를 포함해야 합니다.
NdisPortAuthorizationUnknown
송신 작업에 대한 포트의 권한 부여 상태를 알 수 없습니다.
NdisPortAuthorized
전송 작업에 대한 권한이 포트에 부여됩니다.
NdisPortUnauthorized
포트에는 보내기 작업에 대한 권한이 없습니다.
NdisPortReauthorizing
포트가 보내기 작업에 대한 권한을 다시 부여합니다.
RcvAuthorizationState
수신 작업에 대한 포트의 권한 부여 상태입니다. RcvControlState 멤버가 NdisPortControlStateUncontrolled로 설정된 경우 이 멤버를 무시합니다.
RcvAuthorizationState 는 다음 값 중 하나를 포함해야 합니다.
NdisPortAuthorizationUnknown
수신 작업에 대한 포트의 권한 부여 상태를 알 수 없습니다.
NdisPortAuthorized
포트는 수신 작업에 대한 권한이 부여됩니다.
NdisPortUnauthorized
포트는 수신 작업에 대한 권한이 없습니다.
NdisPortReauthorizing
포트가 수신 작업에 대해 다시 권한을 부여합니다.
설명
NDIS_PORT_CHARACTERISTICS 구조체는 NDIS 포트의 특성을 지정합니다. 이 구조체는 OID_GEN_ENUMERATE_PORTS OID와 함께 사용되는 NDIS_PORT_ARRAY 구조체에 제공되는 포트 특성 목록에 나타납니다.
NDIS 포트를 할당하기 위해 드라이버는 NDIS_PORT_CHARACTERISTICS 구조를 초기화하고 NdisMAllocatePort 함수에 전달합니다. NdisMAllocatePort가 성공적으로 반환되면 NDIS는 NDIS_PORT_CHARACTERISTICSPortNumber 멤버를 NDIS가 포트에 할당한 포트 번호로 설정합니다.
NDIS는 포트 활성화 플러그 앤 플레이(PnP) 이벤트의 연결된 포트 목록을 사용합니다. NDIS는 NDIS_PORT 구조를 사용하여 연결된 포트 목록을 만들고 각 NDIS_PORT 구조에는 NDIS_PORT_CHARACTERISTICS 구조가 포함됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.0 이상에서 지원됩니다. |
| 머리글 | ntddndis.h(Ndis.h 포함) |