NDIS_SWITCH_PORT_PARAMETERS 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_SWITCH_PORT_PARAMETERS 구조에는 Hyper-V 확장 가능한 스위치 포트에 대한 구성 데이터가 포함됩니다.

구문

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

멤버

Header

NDIS_SWITCH_PORT_PARAMETERS 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다. NDIS_SWITCH_PORT_PARAMETERS 구조체의 버전을 지정하려면 Header의 Revision 멤버를 다음 값으로 설정해야 합니다.

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

NDIS 6.30 이상에 대한 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1 설정합니다.

Flags

플래그의 비트 OR 을 포함하는 ULONG 값입니다. 이 멤버는 NDIS용으로 예약되어 있습니다.

PortId

확장 가능한 스위치 포트의 고유 식별자를 포함하는 NDIS_SWITCH_PORT_ID 값입니다.

PortName

확장 가능한 스위치 포트의 고유한 내부 이름을 지정하는 NDIS_SWITCH_PORT_NAME 값입니다.

내부 포트 이름은 WMI 기반 정책 관리 애플리케이션에서 사용됩니다. 자세한 내용은 Hyper-V 확장 가능한 스위치 정책 관리를 참조하세요.

PortFriendlyName

확장 가능한 스위치 포트에 대한 사용자에게 친숙한 설명을 지정하는 NDIS_SWITCH_PORT_FRIENDLYNAME 값입니다.

PortType

확장 가능한 스위치 포트의 형식을 지정하는 NDIS_SWITCH_PORT_TYPE 값입니다.

IsValidationPort

TRUE이면 VM 네트워크 어댑터 연결이 설정되기 전에 테스트 및 유효성 검사를 위해 일시적으로 만들어진 포트를 나타냅니다. 이 포트 유형에 대한 자세한 내용은 유효성 검사 포트를 참조하세요.

PortState

포트의 현재 상태를 지정하는 NDIS_SWITCH_PORT_STATE 값입니다.

설명

NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 다음 OID 요청에 대한 NDIS_SWITCH_PORT_PARAMETERS 구조체에 대한 포인터가 포함되어 있습니다.

OID_SWITCH_PORT_ARRAY OID 쿼리 요청은 요소 배열을 포함하는 NDIS_SWITCH_PORT_ARRAY 구조를 반환합니다. 각 요소의 형식은 NDIS_SWITCH_PORT_PARAMETERS 구조체로 지정됩니다.

확장 가능한 스위치 확장은 NDIS_SWITCH_PORT_AT_ARRAY_INDEX 매크로를 사용하여 NDIS_SWITCH_PORT_PARAMETERS 구조 내의 포트 속성 버퍼에 액세스할 수 있습니다.

참고NDIS_SWITCH_PORT_NAME 및 NDIS_SWITCH_PORT_FRIENDLYNAME 데이터 형식은 IF_COUNTED_STRING 구조에 의해 형식으로 정의됩니다. 이 구조체로 정의된 문자열은 null로 종료할 필요가 없습니다. 그러나 문자열의 길이는 이 구조체의 Length 멤버에서 설정해야 합니다. 문자열이 null로 종료된 경우 Length 멤버는 종료되는 null 문자를 포함하지 않아야 합니다.