OID_SWITCH_PORT_FEATURE_STATUS_QUERY
The protocol edge of the Hyper-V extensible switch issues an object identifier (OID) method request of OID_SWITCH_PORT_FEATURE_STATUS_QUERY to obtain custom status information from an extension about an extensible switch port. 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:
An NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS structure that specifies the parameters for the type of feature status information to be returned.
An NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM structure that contains the feature status information for the extensible switch port.
Remarks
For guidelines on how to handle an OID set request of OID_SWITCH_PORT_FEATURE_STATUS_QUERY, see Managing Custom Port Feature Status Information.
Return Status Codes
The extension returns one of the following status codes for the OID method request of OID_SWITCH_PORT_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_PORT_FEATURE_STATUS_CUSTOM and NDIS_SWITCH_PORT_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_SWITCH_PORT_FEATURE_STATUS_CUSTOM