OID_SWITCH_PARAMETERS
A Hyper-V extensible switch extension issues an object identifier (OID) query request of OID_SWITCH_PARAMETERS to obtain the configuration data of the extensible switch.
If the OID query request completes successfully, the InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to an NDIS_SWITCH_PARAMETERS structure.
Remarks
When the extension processes the returned NDIS_SWITCH_PARAMETERS structure, it must not assume that the various string members of the NDIS_SWITCH_PARAMETERS structure, such as SwitchName, are null-terminated. The data types for these string members are type-defined by the IF_COUNTED_STRING structure. The extension must determine the string length from the value of the Length member of this structure.
Note If the string is null-terminated, the Length member must not include the terminating null character.
Return Status Codes
The underlying miniport edge of the extensible switch completes the OID query request of OID_SWITCH_PARAMETERS and returns one of the following status codes.
| Status Code | Description |
|---|---|
NDIS_STATUS_SUCCESS |
The OID request completed successfully. |
NDIS_STATUS_INVALID_LENGTH |
The length of the information buffer is too small to return the OID_SWITCH_PARAMETERS structure for an OID query request. The underlying miniport edge of the extensible switch sets the DATA.QUERY_INFORMATION.BytesNeeded member in the NDIS_OID_REQUEST structure to the minimum buffer size that is required. |
NDIS_STATUS_FAILURE |
The request failed for other reasons. |
Requirements
Version |
Supported in NDIS 6.30 and later. |
Header |
Ntddndis.h (include Ndis.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for