NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조체(ntddndis.h)

아티클
02/07/2025

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조체는 확장 가능한 Hyper-V 스위치에 대한 프로필 속성 배열을 지정합니다. 배열의 각 요소는 NDIS_SWITCH_PROPERTY_ENUM_INFO 구조체로 서식이 지정됩니다.

통사론

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
} NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS;

회원

Header

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

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

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1 설정합니다.

Flags

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

PropertyType

확장 가능한 switch 속성 형식을 지정하는 NDIS_SWITCH_PROPERTY_TYPE 열거형 값입니다. OID_SWITCH_PROPERTY_ENUM OID 메서드 요청이 실행되면 확장 가능한 스위치 확장은 이 속성 형식과 일치하는 확장 가능한 스위치 속성을 반환합니다.

PropertyId

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

SerializationVersion

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

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

FirstPropertyOffset

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조 뒤에 있는 첫 번째 NDIS_SWITCH_PROPERTY_ENUM_INFO 요소에 대한 오프셋(바이트)을 지정하는 USHORT 값입니다. 오프셋은 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조체의 시작부터 배열의 첫 번째 요소 시작 부분까지 측정됩니다.

참고NumProperties 값이 0이면 이 멤버는 무시됩니다.

NumProperties

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조 뒤에 NDIS_SWITCH_PROPERTY_ENUM_INFO 요소의 수를 지정하는 ULONG 값입니다.

발언

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조체는 OID_SWITCH_PROPERTY_ENUMOID 메서드 요청에 사용됩니다. NDIS_SWITCH_PROPERTY_ENUM_INFO 구조의 배열은 이러한 OID 집합 요청과 연결된 정보 버퍼의 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조를 따릅니다. NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 이 정보 버퍼에 대한 포인터가 포함되어 있습니다.

확장 가능한 스위치 확장은 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO 매크로를 사용하여 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조체에 지정된 첫 번째 NDIS_SWITCH_PROPERTY_ENUM_INFO 구조체에 액세스할 수 있습니다.

확장 가능한 스위치 정책에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 정책참조하세요.