NDIS_SWITCH_NIC_SAVE_STATE - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntddndis.h
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;
View the official Windows Driver Kit DDI referenceNo description available.
The NDIS_SWITCH_NIC_SAVE_STATE structure specifies the run-time state information for a Hyper-V extensible switch port. The extensible switch extension uses this structure to save or restore run-time port information.
HeaderThe type, revision, and size of the NDIS_SWITCH_NIC_SAVE_STATE structure. This member is formatted as an NDIS_OBJECT_HEADER structure.
The Type member of Header must be set to NDIS_OBJECT_TYPE_DEFAULT. To specify the version of the NDIS_SWITCH_NIC_SAVE_STATE structure, the Revision member of Header must be set to the following value:
Original version for NDIS 6.30 and later.
Set the Size member to NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1.
FlagsA ULONG value that contains a bitwise OR of flags. This member is reserved for NDIS.
PortIdAn NDIS_SWITCH_PORT_ID value that contains the unique identifier of the extensible switch port.
NicIndexAn NDIS_SWITCH_NIC_INDEX value that contains the Nic Index for the network adapter. This value will always be 0. For more information, see Network Adapter Index Values.
ExtensionIdA GUID value that identifies the extensible switch extension.
ExtensionFriendlyNameAn NDIS_SWITCH_EXTENSION_FRIENDLYNAME value that specifies the user-friendly description of the extensible switch extension.
FeatureClassIdA GUID value that contains the identifier of the feature class related to the saved data. A feature class identifier is defined by the extension to uniquely identify components of its run-time data.
Note This member is optional. The extensible switch extension must set this member to 0 if the saved data has no feature class.
SaveDataSizeA USHORT value that specified the size, in bytes, of the data that is contained in the SaveData member.
Note This value must be less than or equal to NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE.
SaveDataOffsetA USHORT value that contains the offset from the start of the structure to the run-time state information being saved or restored.
SaveDataSizeOverflowThe NDIS_SWITCH_NIC_SAVE_STATE structure is used in the following OID requests:
Note The NDIS_SWITCH_EXTENSION_FRIENDLYNAME data type is type-defined by the IF_COUNTED_STRING structure. A string that is defined by this structure does not have to be null-terminated. However, the length of the string must be set in the Length member of this structure. If the string is null-terminated, the Length member must not include the terminating null character.
For more information on how to save or restore run-time port information, see Managing Hyper-V Extensible Switch Run-Time Data.