DOT11_PHY_ATTRIBUTES構造 (windot11.h)

[アーティクル]
02/27/2024

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

DOT11_PHY_ATTRIBUTES構造体は、802.11 ステーションの PHY の物理属性と動作属性を定義します。

構文

typedef struct DOT11_PHY_ATTRIBUTES {
  NDIS_OBJECT_HEADER                  Header;
  DOT11_PHY_TYPE                      PhyType;
  BOOLEAN                             bHardwarePhyState;
  BOOLEAN                             bSoftwarePhyState;
  BOOLEAN                             bCFPollable;
  ULONG                               uMPDUMaxLength;
  DOT11_TEMP_TYPE                     TempType;
  DOT11_DIVERSITY_SUPPORT             DiversitySupport;
  union {
    DOT11_HRDSSS_PHY_ATTRIBUTES HRDSSSAttributes;
    DOT11_OFDM_PHY_ATTRIBUTES   OFDMAttributes;
    DOT11_ERP_PHY_ATTRIBUTES    ERPAttributes;
  };
  ULONG                               uNumberSupportedPowerLevels;
  ULONG                               TxPowerLevels[8];
  ULONG                               uNumDataRateMappingEntries;
  DOT11_DATA_RATE_MAPPING_ENTRY       DataRateMappingEntries[DOT11_RATE_SET_MAX_LENGTH];
  DOT11_SUPPORTED_DATA_RATES_VALUE_V2 SupportedDataRatesValue;
} DOT11_PHY_ATTRIBUTES, *PDOT11_PHY_ATTRIBUTES;

メンバー

Header

DOT11_PHY_ATTRIBUTES構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、 ヘッダー のメンバーを次の値に設定する必要があります。

型

このメンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。

リビジョン

このメンバーは、DOT11_PHY_ATTRIBUTES_REVISION_1に設定する必要があります。

サイズ

このメンバーは sizeof(DOT11_PHY_ATTRIBUTES) に設定する必要があります。

これらのメンバーの詳細については、「 NDIS_OBJECT_HEADER」を参照してください。

PhyType

DOT11_PHY_TYPE列挙子値で指定された PHY の型。

bHardwarePhyState

PHY のハードウェア電源状態を指定するブール値。 TRUE の場合、ハードウェアの電源状態が有効になります。 FALSE の場合、ハードウェアの電源状態は無効になります。

PHY のハードウェア電源状態の詳細については、次を参照してください。 OID_DOT11_HARDWARE_PHY_STATE。

メモ PHY のハードウェア電源状態が変更されるたびに、ミニポートドライバーは、メディア固有の状態表示をNDIS_STATUS_DOT11_PHY_STATE_CHANGEDします。

bSoftwarePhyState

PHY のソフトウェア電源状態を指定するブール値。 TRUE の場合、ソフトウェアの電源状態が有効になります。 FALSE の場合、ソフトウェアの電源状態は無効になります。

PHY のソフトウェア電源状態の詳細については、「 OID_DOT11_NIC_POWER_STATE」を参照してください。

メモ PHY のソフトウェア電源状態が変更されるたびに、ミニポートドライバーは、メディア固有の状態表示をNDIS_STATUS_DOT11_PHY_STATE_CHANGEDします。

bCFPollable

TRUE に設定されている場合、802.11 ステーションが CF-Poll フレームをサポートすることを示すブール値。 CF-Poll フレームの詳細については、IEEE 802.11-2012 標準の 9.4 項を参照してください。

このメンバーは拡張アクセスポイント (ExtAP) 操作モードには適用されず、NIC が ExtAP モードの場合は無視されます。

uMPDUMaxLength

PHY が送受信できるメディアアクセス制御 (MAC) プロトコルデータユニット (MPDU) フレームの最大長 (バイト単位)。詳細については、「 OID_DOT11_MPDU_MAX_LENGTH」を参照してください。

メモ PHY のソフトウェア電源状態が変更されるたびに、ミニポートドライバーは、NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGEDメディア固有の状態を示すを行う必要があります。

TempType

DOT11_TEMP_TYPE列挙値によって定義される PHY の動作温度範囲。

DiversitySupport

PHY のアンテナダイバーシティの種類。 DOT11_DIVERSITY_SUPPORT 列挙値によって定義されます。

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

高レートダイレクトシーケンス拡散スペクトル (HRDSS) PHY タイプの PHY 固有の属性。ミニポートドライバーは、 PhyType メンバーがdot11_phy_type_hrdsssに設定されている場合にのみ、このメンバーを使用する必要があります。

PhySpecificAttributes.OFDMAttributes

直交周波数分割多重化 (OFDM) PHY タイプの PHY 固有の属性。ミニポートドライバーは、 PhyType メンバーがdot11_phy_type_ofdmに設定されている場合にのみ、このメンバーを使用する必要があります。

PhySpecificAttributes.ERPAttributes

拡張レート PHY (ERP) タイプの PHY 固有の属性。ミニポートドライバーは、 PhyType メンバーがdot11_phy_type_erpに設定されている場合にのみ、このメンバーを使用する必要があります。

注釈

次に、 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 構造体には、DOT11_PHY_ATTRIBUTES構造体の配列のアドレスを指定するメンバー (pExtPhyAttributes) が含まれています。ミニポートドライバーが NdisMSetMiniportAttributes を呼び出すと、 ドライバーは、 MiniportAttributes パラメーターを、DOT11_PHY_ATTRIBUTES構造体の配列と共にNDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES構造体を含む、ドライバーによって割り当てられたメモリブロックのアドレスに設定します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
Header	windot11.h (Ndis.h を含む)