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 CodeDescription

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

NDIS_OID_REQUEST
NDIS_SWITCH_PARAMETERS
NdisFOidRequest

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft