NDIS_SWITCH_PORT_PROPERTY_PROFILE 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_SWITCH_PORT_PROPERTY_PROFILE 구조체는 확장 가능한 스위치 확장이 Hyper-V 정책 저장소 대신 자체 정책 저장소에 저장하는 Hyper-V 확장 가능 스위치 포트에 대한 정책 속성을 지정합니다. 이 경우 정책 정의는 드라이버의 정책 저장소 내의 속성 프로필로 식별됩니다.

구문

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

멤버

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1 설정합니다.

Flags

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

ProfileName

프로필 속성의 사용자에게 친숙한 이름을 지정하는 NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME 값입니다.

ProfileId

프로필 속성을 고유하게 식별하는 GUID 값입니다.

VendorName

포트 프로필을 정의한 공급업체의 사용자에게 친숙한 이름을 지정하는 NDIS_VENDOR_NAME 값입니다.

VendorId

포트 프로필을 정의한 공급업체를 식별하는 GUID 값입니다.

ProfileData

NetCfgInstanceId

속성이 적용되는 기본 네트워크 어댑터 연결의 NetCfgInstanceId 레지스트리 값을 지정하는 GUID 값입니다.

NetCfgInstanceId 값은 OID_SWITCH_NIC_CREATE OID(개체 식별자) 집합 요청을 통해 네트워크 어댑터 연결에 대해 지정됩니다.

PciLocation

NetCfgInstanceId 멤버로 지정된 기본 물리적 네트워크 어댑터의 PCI 위치를 지정하는 구조체입니다.

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

PciLocation.PciSegmentNumber

실제 네트워크 어댑터가 연결된 PCI 버스 그룹을 지정하는 값입니다.

PciLocation.PciBusNumber

실제 네트워크 어댑터가 연결된 현재 PCI 버스 번호를 지정하는 값입니다.

PciLocation.PciDeviceNumber

PCI 버스의 실제 네트워크 어댑터에 대한 디바이스 번호를 지정하는 값입니다.

참고 PCI 디바이스 번호를 PCI 슬롯 번호라고도 합니다.

PciLocation.PciFunctionNumber

물리적 네트워크 어댑터에서 논리 디바이스의 함수 번호를 지정하는 값입니다.

CdnLabelId

CdnLabel 멤버에 포함된 데이터의 고유 식별자를 지정하는 UINT32 값입니다.

CdnLabel

실제 네트워크 어댑터의 위치에 대한 PCI Express(PCIe) CDN 레이블을 지정하는 NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL 값입니다. CDN 레이블은 유사한 하드웨어 위치에서 일관된 디바이스 위치를 제공합니다.

설명

NDIS_SWITCH_PORT_PROPERTY_PROFILE 구조는 확장에서 Hyper-V 정책 저장소 대신 프라이빗 정책 저장소 내의 정책 속성을 참조하는 데 사용됩니다. 이를 통해 ISV(독립 소프트웨어 공급업체)는 프라이빗 채널 및 인터페이스를 통해 이 개인 정책 저장소를 채우고 관리할 수 있습니다. 공급업체는 VendorName 및 VendorId 필드를 사용하여 다른 공급업체의 프로필과 프로필을 구분할 수 있습니다.

참고NDIS_SWITCH_PORT_PROPERTY_PROFILE 구조로 지정된 포트 정책 속성은 확장 가능한 스위치 인터페이스에 투명합니다.

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

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

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

PciLocation 및 CdnLabel 멤버는 속성 프로필이 확장 가능한 스위치 외부 네트워크 어댑터에 연결된 기본 물리적 네트워크 어댑터에 대한 정책을 지정하는 경우에만 관련이 있습니다. 예를 들어 외부 네트워크 어댑터가 어댑터의 확장 가능한 스위치 팀에 바인딩된 경우 이러한 멤버는 해당 팀의 단일 어댑터에 대한 정책을 지정할 수 있습니다. 확장 가능한 스위치 팀에 대한 자세한 내용은 물리적 네트워크 어댑터 구성 유형을 참조하세요.