DOT11_EXTSTA_SEND_CONTEXT構造 (windot11.h)

[アーティクル]
08/08/2023

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

DOT11_EXTSTA_SEND_CONTEXT構造体は、拡張可能ステーション (ExtSTA) モードで動作しているミニポートドライバーによって送信されるパケットのネイティブ 802.11 属性を定義します。この操作モードの詳細については、「拡張ステーション操作モード」を参照してください。

構文

typedef struct DOT11_EXTSTA_SEND_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  USHORT             usExemptionActionType;
  ULONG              uPhyId;
  ULONG              uDelayedSleepValue;
  PVOID              pvMediaSpecificInfo;
  ULONG              uSendFlags;
} DOT11_EXTSTA_SEND_CONTEXT, *PDOT11_EXTSTA_SEND_CONTEXT;

メンバー

Header

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

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

型

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

リビジョン

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

サイズ

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

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

usExemptionActionType

パケットの暗号化除外の種類。次の除外の種類が定義されています。

DOT11_EXEMPT_NO_EXEMPTION

パケットは、802.11 ステーションによって実行される暗号操作から除外されません。

DOT11_EXEMPT_ALWAYS

パケットは、802.11 ステーションによって実行されるすべての暗号操作から除外されます。 802.11 ステーションは、暗号化されていないパケットを送信する必要があります。

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

パケットは、パケットの宛先メディアアクセス制御 (MAC) アドレスのキーマッピングキーがない場合にのみ、802.11 ステーションによって実行される暗号操作から除外されます。キーマッピングキーの詳細については、「 802.11 暗号キーの種類」を参照してください。

uPhyId

802.11 ステーション上の PHY 型の識別子 (ID)。 802.11 ステーションは、指定された PHY を使用してパケットを送信する必要があります。

uPhyId の値は、次のいずれかである必要があります。

msDot11ActivePhyList MIB オブジェクトによって定義されたアクティブな PHY 型のリスト内のエントリの値。ミニポートドライバーは、現在の基本的なサービスセット (BSS) ネットワーク接続で使用するためにアクティブ化されている PHY の一覧にこの MIB オブジェクトを設定します。 msDot11ActivePhyList MIB オブジェクトの詳細については、「OID_DOT11_ACTIVE_PHY_LIST」を参照してください。
DOT11_PHY_ID_ANYの値。この場合、802.11 ステーションは 、msDot11ActivePhyList MIB オブジェクトによって定義されたアクティブな PHY の一覧から任意の PHY を使用できます。

uPhyId で指定された PHY がサポートされていないか、独立したハードウェアベンダー (IHV) によって実装された独自のメカニズムによって無効になっている場合、ミニポートドライバーは送信要求を失敗させる必要があります。この状況では、ミニポートドライバーは、NDIS_STATUS_UNSUPPORTED_MEDIAし、呼び出しにNET_BUFFER_LIST構造体の状態メンバーを設定します。 NdisMSendNetBufferListsComplete で送信要求を完了します。

uDelayedSleepValue

パケットへの応答が予想されるまでの時間 (マイクロ秒単位)。 uDelayedSleepValue メンバーは、次のすべてが当てはまる場合にのみ有効です。

パケットは、メディアアクセス制御 (MAC) サービスデータユニット (MSDU) パケットです。
802.11 ステーションは、省電力 (PS) モードで動作しています。この状況では、Extensible Station (ExtSTA) msDot11PowerSavingLevel 管理情報ベース (MIB) オブジェクトには、DOT11_POWER_SAVING_NO_POWER_SAVINGを除く任意の値があります。 msDot11PowerSavingLevel MIB 値の詳細については、以下を参照してください。 OID_DOT11_POWER_MGMT_REQUEST。

802.11 ステーションでは 、uDelayedSleepValue の値を使用して、PS モードで動作している間のネットワークパフォーマンスを最適化します。たとえば、PS モードによっては、 uDelayedSleepValue が小さい場合、802.11 ステーションはパケットの送信後も無線をオンにしたままにすることがあります。これにより、応答を受信するためのネットワーク待機時間が短縮されます。

pvMediaSpecificInfo

メディア固有の情報を含むバッファーへのポインター。この構造体が関連付けられている 802.11 NET_BUFFER_LIST構造体がネイティブ 802.11 フレームワーク自体から取得される場合 (IHV 拡張機能から取得されるNET_BUFFER_LIST構造体を含む) 場合、このメンバーは NULL にする必要があります。

それ以外の場合、pvMediaSpecificInfo は、元の 802.3 NET_BUFFER_LIST構造体の NetBufferListInfo メンバーにある MediaSpecificInformation エントリに関連付けられている帯域外 (OOB) データを指します。 pvMediaSpecificInfo を使用すると、ミニポートドライバーは IHV 固有の 802.3 プロトコルドライバーからメディア固有の情報にアクセスできます。

uSendFlags

送信属性を定義するフラグのセット。現時点では、フラグは定義されていません。このメンバーは 0 にする必要があります。

注釈

ミニポートドライバーは、その場合に送信操作を実行します。 MiniportSendNetBufferLists が呼び出されます。この関数を介してドライバーに渡される各パケットは、ネイティブ 802.11 アウトオブバンド (OOB) データを含む NET_BUFFER_LIST 構造体によって定義されます。 OOB データには、802.11 ステーションがパケットの送信時に使用するメディア固有のパラメーターが含まれています。

ミニポートドライバーは、次のパラメーターを使用して、NET_BUFFER_LIST_INFO マクロを介してネイティブ 802.11 OOB データにアクセスします。

_NBL パラメーター。これは、受信した 802.11 パケットに使用されるNET_BUFFER_LIST構造体へのポインターを渡します。
_ id パラメーター。 MediaSpecificInformation の識別子 (ID) 値が渡されます。

Native 802.11 送信操作の詳細については、「 Native 802.11 送信操作」を参照してください。

要件

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