共用方式為

OID_DOT11_SUPPORTED_PHY_TYPES (Compact 2013)

  • 發行項

3/26/2014

When queried, this OID requests that the miniport driver return the value of the Native 802.11 Operational msDot11SupportedPhyTypes management information base (MIB) object. This MIB object defines the list of PHY types supported by the 802.11 station.

The data type for this OID is the DOT11_SUPPORTED_PHY_TYPES structure.

The following points apply to a miniport driver operating in Extensible Station (ExtSTA) mode:

  • When OID_DOT11_SUPPORTED_PHY_TYPES is queried, the miniport driver must add an entry in the dot11PHYType array for every PHY that is supported on the 802.11 station. If the 802.11 station supports proprietary or non-standard PHY types, the miniport driver must add an entry that contains a PHY type value that is defined by the independent hardware vendor (IHV). For more information about IHV-defined PHY types, see DOT11_PHY_TYPE.
    If the 802.11 station supports multiple PHYs of the same type, the miniport driver must add separate entries for each PHY.
  • The number of entries within the dot11PHYType array and the order of the entries within the array must remain unchanged during the lifetime of the installation of the miniport driver.
    For any PHY type supported by the 802.11 station, its index within the dot11PHYType array must persist and not change while the miniport driver is installed on the host computer system.

After OID_DOT11_SUPPORTED_PHY_TYPES is queried, the operating system will identify a PHY on the 802.11 station by using one of the following methods:

  • If the miniport driver is operating in ExtSTA mode, the operating system will identify the PHY through a PHY identifier (ID). The PHY ID is the index into the list of PHYs that are returned in the dot11PHYType array. If the operating system specifies a PHY ID of DOT11_PHY_ID_ANY, the miniport driver can use any supported PHY on the 802.11 station.
    The miniport driver also uses the PHY ID for Native 802.11 media-specific status indications. The miniport driver cannot use DOT11_PHY_ID_ANY as a PHY ID for status indications. For more information about Native 802.11 media-specific status indications, see Native 802.11 Wireless LAN Status Indications.
  • If the miniport driver is not operating in ExtSTA mode, the operating system will identify the PHY through a PHY type as defined by a DOT11_PHY_TYPE enumeration value.

When OID_DOT11_SUPPORTED_PHY_TYPES is queried, the miniport driver must verify that the InformationBuffer member of the MiniportOidRequest function’s OidRequest parameter is large enough to return the complete DOT11_SUPPORTED_PHY_TYPES structure, including all entries in the dot11PHYType array. The value of the InformationBufferLength member of the OidRequest parameter determines what the miniport driver must do, for example:

  • If the value of the InformationBufferLength member is less than the length, in bytes, of the complete DOT11_SUPPORTED_PHY_TYPES structure, the miniport driver must do the following:
    • For the OidRequest parameter, set the BytesWritten member to zero and the BytesNeeded member to the length, in bytes, of the complete DOT11_SUPPORTED_PHY_TYPES structure.
    • Fail the query request by returning NDIS_STATUS_BUFFER_OVERFLOW from its MiniportOidRequest function.
  • If the value of the InformationBufferLength member is greater than or equal to the length, in bytes, of the complete DOT11_SUPPORTED_PHY_TYPES structure, the miniport driver must do the following to complete a successful query request:
    • For the DOT11_SUPPORTED_PHY_TYPES structure, set the uNumOfEntries and uTotalNumOfEntries members to the total number of entries in the dot11PHYType array.
    • For the OidRequest parameter, set the BytesNeeded member to zero and the BytesWritten member to the length, in bytes, of the complete DOT11_SUPPORTED_PHY_TYPES structure. The miniport driver must also copy the complete DOT11_SUPPORTED_PHY_TYPES structure to the InformationBuffer member.
    • Return NDIS_STATUS_SUCCESS from its MiniportOidRequest function.

Requirements

Header

windot11.h

See Also

Reference

NDIS 5.x Legacy Wireless LAN OIDs
DOT11_SUPPORTED_PHY_TYPES
Native 802.11 Wireless LAN Status Indications
MiniportOidRequest
Native 802.11 Operational OIDs
NDIS 5.x Legacy Reference

Other Resources

DOT11_PHY_TYPE