DOT11_EXTSTA_SEND_CONTEXT構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
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 を使用できます。
uDelayedSleepValue
パケットへの応答が予想される前の時間 (マイクロ秒単位)。 uDelayedSleepValue メンバーは、次のすべてが当てはまる場合にのみ有効です。
- パケットは、メディア アクセス制御 (MAC) サービス データ ユニット (MSDU) パケットです。
- 802.11 ステーションは、節電 (PS) モードで動作しています。 このような状況では、msDot11PowerSavingLevel 管理情報ベース (MIB) オブジェクト 拡張ステーション (ExtSTA) には、DOT11_POWER_SAVING_NO_POWER_SAVINGを除く任意の値があります。 msDot11PowerSavingLevel MIB 値 の詳細については、 OID_DOT11_POWER_MGMT_REQUEST.
pvMediaSpecificInfo
メディア固有の情報を含むバッファーへのポインター。 この構造体が関連付けられている 802.11 NET_BUFFER_LIST 構造体がネイティブ 802.11 フレームワーク自体から取得されている場合、このメンバーは NULL する必要があります (IHV 拡張機能から取得されるNET_BUFFER_LIST構造体を含む)。
それ以外の場合、pvMediaSpecificInfo は、元の 802.3 NET_BUFFER_LIST構造体の NetBufferListInfo メンバーにある MediaSpecificInformation エントリに関連付けられている帯域外 (OOB) データを指します。 pvMediaSpecificInfo を すると、ミニポート ドライバーは IHV 固有の 802.3 プロトコル ドライバーからメディア固有の情報にアクセスできます。
uSendFlags
送信属性を定義するフラグのセット。 現時点では、フラグは定義されていません。 このメンバーは 0 にする必要があります。
備考
ミニポート ドライバーは、そのときに送信操作を実行します。 ミニポートSendNetBufferLists が呼び出されます。 この関数を介してドライバーに渡される各パケットは、ネイティブ 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) 値渡されます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |