Edit

OID_SWITCH_FEATURE_STATUS_QUERY

  • Article

The protocol edge of the Hyper-V extensible switch issues an object identifier (OID) method request of OID_SWITCH_FEATURE_STATUS_QUERY to obtain custom status information from an extension about the extensible switch. This information is known as feature status information. The format of this information is defined by the independent software vendor (ISV).

After a successful return from this OID method request, the InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to a buffer. This buffer contains the following data:

Remarks

For guidelines on how to handle an OID set request of OID_SWITCH_FEATURE_STATUS_QUERY, see Managing Custom Switch Feature Status Information.

Return Status Codes

The extension returns one of the following status codes for the OID method request of OID_SWITCH_FEATURE_STATUS_QUERY.

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 feature status information as well as the NDIS_SWITCH_FEATURE_STATUS_CUSTOM and NDIS_SWITCH_FEATURE_STATUS_PARAMETERS structures. The underlying miniport edge of the extensible switch sets the DATA.METHOD_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_PROPERTY_TYPE

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS