DOT11EXT_SET_ETHERTYPE_HANDLING コールバック関数 (wlanihv.h)

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバー モデル」を参照してください。
 
IHV 拡張機能 DLL は Dot11ExtSetEtherTypeHandling 関数を呼び出して、次の操作を行います。
  • パケット復号化除外の一覧を使用して、ワイヤレス LAN (WLAN) アダプターを構成します。 各除外は、受信パケットの IEEE EtherType に基づいて適用されます。
  • Dot11ExtIhvReceivePacket IHV ハンドラー関数の呼び出しによって IHV 拡張機能 DLL に転送される受信パケットの EtherTypes のオペレーティング システムに登録します。

構文

DOT11EXT_SET_ETHERTYPE_HANDLING Dot11extSetEthertypeHandling;

DWORD Dot11extSetEthertypeHandling(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uMaxBackLog,
  [in]           ULONG uNumOfExemption,
  [in, optional] PDOT11_PRIVACY_EXEMPTION pExemption,
  [in]           ULONG uNumOfRegistration,
  [in, optional] USHORT *pusRegistration
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

オペレーティング システムが WLAN アダプターを参照するために使用するハンドル。 このハンドル値は、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の以前の呼び出しによって指定されました。

[in] uMaxBackLog

Dot11ExtIhvReceivePacket IHV ハンドラー関数の呼び出しから IHV 拡張機能 DLL が返されていない場合にオペレーティング システムがキューに入れた受信パケットの最大数。 uMaxBackLog に達すると、オペレーティング システムはキュー内の最も古いパケットを破棄します。

[in] uNumOfExemption

pExemption パラメーターによって参照されるプライバシー除外配列内のエントリの数。 値が 0 の場合、WLAN アダプターのプライバシーの除外が無効になります。

[in, optional] pExemption

プライバシー除外の配列へのポインター。 配列内の各エントリは、 DOT11_PRIVACY_EXEMPTION 構造体。

[in] uNumOfRegistration

pusRegistration パラメーターによって参照される IEEE EtherType 登録配列内のエントリの数。 値が 0 の場合、IHV 拡張機能 DLL が Dot11ExtIhvReceivePacket IHV ハンドラー関数の呼び出しを介してパケットを受信する機能が無効になります。

[in, optional] pusRegistration

IEEE EtherType 登録の配列へのポインター。 各エントリには、ビッグ エンディアン形式の EtherType 値があります。

戻り値

呼び出しが成功した場合、関数は ERROR_SUCCESSを返します。 それ以外の場合は、Winerror.h で定義されたエラー コードが返されます。

注釈

Dot11ExtSetEtherTypeHandling 関数を呼び出すとき、IHV 拡張機能 DLL は次のガイドラインに従う必要があります。

  • IHV 拡張機能 DLL は、Dot11ExtIhvInitAdapter または の呼び出し内から Dot11ExtSetEtherTypeHandling を呼び出すことができます。 Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数。
  • IHV 拡張機能 DLL は、 の呼び出しによって関連付け前操作が正常に完了した後、 Dot11ExtSetEtherTypeHandling を呼び出してはなりません Dot11ExtPreAssociateCompletion
オペレーティング システムは、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の呼び出しの前に、プライバシー除外と EtherType 登録の空のリストに既定で設定されます。

要件

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

こちらもご覧ください

Dot11ExtIhvReceivePacket

DOT11_PRIVACY_EXEMPTION

Dot11ExtIhvInitAdapter

Dot11ExtPreAssociateCompletion

ネイティブ 802.11 IHV ハンドラー関数

Dot11ExtIhvPerformPreAssociate