NDIS_SWITCH_PARAMETERS 구조체(ntddndis.h)

아티클
08/07/2023

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

구문

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

멤버

Header

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

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

NDIS_SWITCH_PARAMETERS_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1 설정합니다.

Flags

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

SwitchName

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

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

SwitchFriendlyName

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

NumSwitchPorts

확장 가능한 스위치에 구성된 포트 수를 지정하는 UINT32 값입니다.

IsActive

TRUE이면 Hyper-V 확장 가능한 스위치 활성화가 완료되었으며 포트, NIC 및 속성 열거와 같은 다른 스위치 구성을 쿼리하는 것이 안전하다는 것을 나타내는 BOOLEAN입니다. FALSE인 경우 확장은 스위치 구성을 쿼리하기 전에 NetEventSwitchActivate PNP 이벤트가 실행될 때까지 기다려야 합니다.

설명

NDIS_SWITCH_PARAMETERS 구조체는 OID_SWITCH_PARAMETERS OID 요청에 사용됩니다.

이 구조체는 Windows Filtering Platform 설명선 드라이버에 대해 다음 설명선 함수의 vSwitch 매개 변수에도 전달됩니다.

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