NDIS_SWITCH_PARAMETERS - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntddndis.h
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;
View the official Windows Driver Kit DDI referenceNo description available.
The NDIS_SWITCH_PARAMETERS structure contains the configuration data for a Hyper-V extensible switch.
HeaderThe type, revision, and size of the NDIS_SWITCH_PARAMETERS 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_PARAMETERS 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_PARAMETERS_REVISION_1.
FlagsA ULONG value that contains a bitwise OR of flags. This member is reserved for NDIS.
SwitchNameAn NDIS_SWITCH_NAME value that specifies the unique internal name of the extensible switch.
The internal switch name is used by WMI-based policy management applications. For more information, see Managing Hyper-V Extensible Switch Policies.
SwitchFriendlyNameAn NDIS_SWITCH_FRIENDLYNAME value that specifies the user-friendly description of the extensible switch.
NumSwitchPortsA UINT32 value that specifies the number of ports configured on the extensible switch.
IsActiveA BOOLEAN that if TRUE indicates that the Hyper-V extensible switch activation has finished and it is safe to query for other switch configuration such as enumerating ports, NICs, and properties. If FALSE, the extension must wait for the NetEventSwitchActivate PNP event to be issued before querying for switch configuration.
The NDIS_SWITCH_PARAMETERS structure is used in the OID request of OID_SWITCH_PARAMETERS.
This structure is also passed in the vSwitch parameter of the following callout functions for Windows Filtering Platform callout drivers:
Note The NDIS_SWITCH_NAME and NDIS_SWITCH_FRIENDLYNAME data types are 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.
FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0
FWPS_VSWITCH_POLICY_EVENT_CALLBACK0
FWPS_VSWITCH_PORT_EVENT_CALLBACK0
FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0
FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0
IF_COUNTEDFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0