NDIS_SWITCH_NIC_SAVE_STATE 구조체(ntddndis.h)

아티클
02/26/2024

NDIS_SWITCH_NIC_SAVE_STATE 구조체는 Hyper-V 확장 가능한 스위치 포트에 대한 런타임 상태 정보를 지정합니다. 확장 가능한 스위치 확장은 이 구조를 사용하여 런타임 포트 정보를 저장하거나 복원합니다.

구문

typedef struct _NDIS_SWITCH_NIC_SAVE_STATE {
  NDIS_OBJECT_HEADER                 Header;
  ULONG                              Flags;
  NDIS_SWITCH_PORT_ID                PortId;
  NDIS_SWITCH_NIC_INDEX              NicIndex;
  GUID                               ExtensionId;
  NDIS_SWITCH_EXTENSION_FRIENDLYNAME ExtensionFriendlyName;
  GUID                               FeatureClassId;
  USHORT                             SaveDataSize;
  USHORT                             SaveDataOffset;
  ULONG                              SaveDataSizeOverflow;
} NDIS_SWITCH_NIC_SAVE_STATE, *PNDIS_SWITCH_NIC_SAVE_STATE;

멤버

Header

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

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

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 설정합니다.

Flags

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

PortId

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

NicIndex

네트워크 어댑터에 대한 Nic 인덱스를 포함하는 NDIS_SWITCH_NIC_INDEX 값입니다. 이 값은 항상 0입니다. 자세한 내용은 네트워크 어댑터 인덱스 값을 참조하세요.

ExtensionId

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

ExtensionFriendlyName

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

FeatureClassId

저장된 데이터와 관련된 기능 클래스의 식별자를 포함하는 GUID 값입니다. 기능 클래스 식별자는 확장에 의해 정의되어 런타임 데이터의 구성 요소를 고유하게 식별합니다.

참고 이 멤버는 선택 사항입니다. 저장된 데이터에 기능 클래스가 없는 경우 확장 가능한 스위치 확장은 이 멤버를 0으로 설정해야 합니다.

SaveDataSize

SaveData 멤버에 포함된 데이터의 크기(바이트)를 지정한 USHORT 값입니다.

참고 이 값은 NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE 작거나 같아야 합니다.

SaveDataOffset

구조체의 시작부터 저장 또는 복원되는 런타임 상태 정보까지의 오프셋을 포함하는 USHORT 값입니다.

SaveDataSizeOverflow

설명

NDIS_SWITCH_NIC_SAVE_STATE 구조는 다음 OID 요청에 사용됩니다.

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

런타임 포트 정보를 저장하거나 복원하는 방법에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 Run-Time 데이터 관리를 참조하세요.