NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조체(ntddndis.h)

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조체는 Hyper-V 확장 가능 스위치의 사용자 지정 상태 정보에 대한 매개 변수를 지정합니다. 이 정보를 기능 상태 정보라고 합니다. 이 정보의 형식은 ISV(독립 소프트웨어 공급업체)에 의해 정의됩니다.

상태 정보는 OID_SWITCH_FEATURE_STATUS_QUERY OID(개체 식별자) 메서드 요청을 통해 반환되는 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 구조를 통해 지정됩니다.

구문

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

멤버

Header

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

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1 설정합니다.

Flags

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

FeatureStatusType

확장 가능한 스위치에 대한 기능 상태 정보의 형식을 지정하는 NDIS_SWITCH_FEATURE_STATUS_TYPE 열거형 값입니다.

참고 NDIS 6.30부터 이 멤버는 NdisSwitchFeatureStatusTypeCustom으로 설정해야 합니다.
 

FeatureStatusId

확장 가능한 스위치에 대한 기능 상태 정보를 식별하는 GUID 값입니다.

이 값은 기능 상태 정보에 대한 MOF(관리 개체 형식) 클래스 정의로 정의됩니다. 자세한 내용은 사용자 지정 스위치 속성 정의 및 등록을 참조하세요.

FeatureStatusInstanceId

확장 가능한 스위치에 대한 기능 상태 정보의 인스턴스를 식별하는 NDIS_SWITCH_OBJECT_INSTANCE_ID 값입니다.

FeatureStatusVersion

확장 가능한 스위치에 대한 기능 상태 정보의 버전을 식별하는 NDIS_SWITCH_OBJECT_VERSION 값입니다. 이 값은 기능 상태 정보에 대한 MOF 클래스 정의에 정의되어 있습니다.

SerializationVersion

기능 상태 정보에 대한 직렬화된 상태 정보의 형식 버전을 식별하는 NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION 값입니다. 이 데이터는 속성을 정의한 MOF 파일의 확장에 의해 액세스를 위해 직렬화됩니다.

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

FeatureStatusBufferOffset

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조 뒤에 있는 기능 상태 버퍼에 대한 오프셋(바이트)을 지정하는 ULONG 값입니다. 상태 버퍼에는 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 구조체가 포함됩니다.

오프셋은 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조체의 시작부터 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 구조체의 시작 부분까지 측정됩니다.

FeatureStatusBufferLength

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

설명

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조는 OID_SWITCH_FEATURE_STATUS_QUERY OID 메서드 요청에 사용됩니다. 이 OID 요청은 OID 요청과 연결된 정보 버퍼에서 다음 구조를 반환합니다.

  • 확장 가능한 스위치의 기능 상태 정보에 대한 상태 매개 변수를 지정하는 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조체입니다. 스위치 확장은 구조체의 FeatureStatusVersion 멤버를 채워 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 버퍼에 반환되는 사용자 지정 상태의 버전을 반영합니다. Hyper-v Extensible 스위치는 쿼리 OID를 발급할 때 다른 모든 멤버를 채웁니다.
  • 확장 가능한 스위치에 대한 기능 상태 정보를 포함하는 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 구조체입니다. 스위치 확장은 반환되는 사용자 지정 상태의 크기를 반영하도록 구조체의 FeatureStatusCustomBufferLength 멤버를 채웁니다. Hyper-v Extensible 스위치는 쿼리 OID를 발급할 때 다른 모든 멤버를 채웁니다.

요구 사항

   
지원되는 최소 클라이언트 NDIS 6.30 이상에서 지원됩니다.
헤더 ntddndis.h(Ndis.h 포함)

참고 항목

NDIS_OBJECT_HEADER

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_TYPE

OID_SWITCH_FEATURE_STATUS_QUERY