NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체는 Hyper-V 확장 가능한 스위치 포트의 정책 속성에 대한 매개 변수를 지정합니다.

구문

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

멤버

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1 설정합니다.

Flags

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

PortId

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

PropertyType

속성 버퍼 내에 포함된 포트 속성의 형식을 지정하는 NDIS_SWITCH_PORT_PROPERTY_TYPE 열거형 값입니다.

PropertyId

확장 가능한 스위치 포트의 속성을 식별하는 GUID 값입니다.

자세한 내용은 주의 섹션을 참조하세요.

참고PropertyType 멤버가 NdisSwitchPortPropertyTypeCustom으로 설정되지 않는 한 확장 가능한 스위치 확장은 이 멤버를 무시해야 합니다.

PropertyVersion

확장 가능한 스위치 포트에 대한 속성의 버전을 식별하는 NDIS_SWITCH_OBJECT_VERSION 값입니다.

SerializationVersion

직렬화된 포트 속성 데이터의 형식 버전을 식별하는 NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION 값입니다. 이 데이터는 속성을 정의한 MOF(Managed Object Format) 파일의 확장에 의해 액세스하기 위해 직렬화됩니다.

참고 Windows Server 2012 경우 SerializationVersion 멤버를 NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1 설정해야 합니다.

PropertyInstanceId

확장 가능한 스위치 포트에 대한 속성의 instance 식별하는 NDIS_SWITCH_OBJECT_INSTANCE_ID 값입니다.

PropertyBufferLength

속성 버퍼의 크기(바이트)를 지정하는 ULONG 값입니다.

PropertyBufferOffset

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체를 따르는 속성 버퍼에 대한 오프셋(바이트)을 지정하는 ULONG 값입니다. 오프셋은 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체의 시작부터 속성 버퍼의 시작 부분까지 측정됩니다.

Reserved

다음에 사용하도록 예약됩니다.

설명

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체는 다음 OID 집합 요청에 사용됩니다.

속성 버퍼에는 PropertyType 멤버와 연결된 구조체가 포함되어 있습니다. 속성 버퍼는 이러한 OID 집합 요청과 연결된 정보 버퍼의 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조를 따릅니다. NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 이 정보 버퍼에 대한 포인터가 포함되어 있습니다.

확장 가능한 스위치 확장은 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조를 처리할 때 다음 지침을 따라야 합니다.

PropertyType 멤버가 NdisSwitchPortPropertyTypeSecurity로 설정된 경우 속성 버퍼는 NDIS_SWITCH_PORT_PROPERTY_SECURITY 구조체로 형식이 지정됩니다.
PropertyType 멤버가 NdisSwitchPortPropertyTypeVlan으로 설정된 경우 속성 버퍼는 NDIS_SWITCH_PORT_PROPERTY_VLAN 구조체로 형식이 지정됩니다.
PropertyType 멤버가 NdisSwitchPortPropertyTypeProfile로 설정된 경우 속성 버퍼는 NDIS_SWITCH_PORT_PROPERTY_PROFILE 구조체로 형식이 지정됩니다.
PropertyType 멤버가 NdisSwitchPortPropertyTypeCustom으로 설정된 경우 PropertyId 멤버를 사용자 지정 포트 속성에 대해 만든 ISV(독립 소프트웨어 공급업체)의 GUID 값으로 설정해야 합니다. 속성 버퍼는 ISV에서 정의한 대로 사용자 지정 포트 속성에 대한 매개 변수를 포함하는 NDIS_SWITCH_PORT_PROPERTY_CUSTOM 구조체로 형식이 지정됩니다.