ネイティブ 802.11 IHV 拡張性関数

重要

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

ネイティブ 802.11 IHV 拡張性関数は、オペレーティング システムによって提供され、IHV 拡張機能 DLL によって呼び出されて次の操作を実行します。

  • ネイティブ 802.11 フレームワーク内で使用されるバッファーを割り当て、解放します。
  • IHV のワイヤレス LAN (WLAN) アダプター経由で、認証アルゴリズムによって定義されたパケットなどのパケットを送信します。
  • IHV 拡張機能 DLL でサポートされている認証アルゴリズムと暗号アルゴリズムに対して、さまざまなセキュリティ設定を使用して IHV の WLAN アダプターを構成します。
  • IHV UI 拡張機能 DLL (インストールされている場合) と連動して、イベント通知を処理します。 たとえば、IHV 拡張機能 DLL は、BSS (Basic Service Set) ネットワーク接続に関わる各種ステージについて IHV UI 拡張機能 DLL に通知できます。

IHV UI 拡張機能 DLL の詳細については、「ネイティブ 802.11 IHV UI 拡張機能 DLL」を参照してください。

Note

IHV 拡張機能 DLL は、DOT11EXT_APIS 構造体のメンバーに関連付けられた関数ポインターを介して、各ネイティブ 802.11 IHV 拡張性関数を呼び出します。 オペレーティング システムは、Dot11ExtIhvInitService IHV ハンドラー関数を呼び出すと、pDot11ExtAPI パラメーターを使用して IHV 拡張性関数へのポインターの一覧を渡します。

次の表に、IHV 拡張機能 DLL によって呼び出すことができるネイティブ 802.11 IHV 拡張性関数の一覧を示します。 各 IHV 拡張性関数は、これらの条件下でのみ呼び出すことができます。

  • サービスの初期化後に呼び出される
    IHV 拡張性関数は、IHV 拡張機能 DLL を初期化するために Dot11ExtIhvInitService IHV ハンドラー関数が呼び出された後にのみ、呼び出すことができます。 また、この拡張機能 DLL は、Dot11ExtIhvDeinitService IHV ハンドラー関数が呼び出された後に IHV 拡張性関数を呼び出すことができません。
  • アダプターの初期化後に呼び出される
    IHV 拡張性関数は、IHV の WLAN アダプターへのインターフェイスを初期化するために Dot11ExtIhvInitAdapter IHV ハンドラー関数が呼び出された後にのみ、呼び出すことができます。
    IHV 拡張性関数には、WLAN アダプターを識別するハンドルが必要です。 Dot11ExtIhvInitAdapter が呼び出されると、IHV 拡張機能 DLL は hDot11SvcHandle パラメーターを介してこのハンドルを渡されます。
    この拡張機能 DLL は、Dot11ExtIhvDeinitAdapter IHV ハンドラー関数が呼び出された後に IHV 拡張性関数を呼び出すことができません。
  • 事前関連付け後に呼び出される
    IHV 機能性関数は、BSS (Basic Service Set) ネットワークとの事前関連付け操作を開始するために Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数が呼び出された後にのみ、呼び出すことができます。
    IHV 機能性関数には、BSS ネットワーク接続を識別するハンドルが必要です。 Dot11ExtIhvPerformPreAssociate が呼び出されると、IHV 拡張機能 DLL は hConnection パラメーターを介してこのハンドルを渡されます。
    拡張機能 DLL は、Dot11ExtIhvDeinitAdapter または Dot11ExtIhvAdapterReset の IHV ハンドラー関数が呼び出された後に IHV 拡張性関数を呼び出すことはできません。
  • 事後関連付け後に呼び出される
    IHV 機能性関数は、BSS (Basic Service Set) ネットワークとの事後関連付け操作を開始するために Dot11ExtIhvPerformPostAssociate IHV ハンドラー関数が呼び出された後にのみ、呼び出すことができます。
    IHV 拡張性関数には、BSS ネットワーク接続とのセキュリティ セッションを識別するハンドルが必要です。 Dot11ExtIhvPerformPostAssociate が呼び出されると、IHV 拡張機能 DLL は hSecuritySessionID パラメーターを介してこのハンドルを渡されます。
    拡張機能 DLL は、Dot11ExtIhvDeinitAdapter または Dot11ExtIhvAdapterReset の IHV ハンドラー関数が呼び出された後に IHV 拡張性関数を呼び出すことはできません。
機能 サービスの初期化後に呼び出される アダプターの初期化後に呼び出される 事前関連付け後に呼び出される 事後関連付け後に呼び出される
Dot11ExtAllocateBuffer x
Dot11ExtFreeBuffer x
Dot11ExtGetProfileCustomUserData x
Dot11ExtNicSpecificExtension x
Dot11ExtStartOneX x
Dot11ExtStopOneX x
Dot11ExtPostAssociateCompletion x
Dot11ExtPreAssociateCompletion x
Dot11ExtProcessOneXPacket x
Dot11ExtQueryVirtualStationProperties x
Dot11ExtReleaseVirtualStation x
Dot11ExtRequestVirtualStation x
Dot11ExtSendNotification x
Dot11ExtSendUIRequest x
Dot11ExtSetAuthAlgorithm x
Dot11ExtSetCurrentProfile x
Dot11ExtSetDefaultKey x
Dot11ExtSetDefaultKeyId x
Dot11ExtSetEtherTypeHandling x
Dot11ExtSetExcludeUnencrypted x
Dot11ExtSetKeyMappingKey x
Dot11ExtSetMulticastCipherAlgorithm x
Dot11ExtSetProfileCustomUserData x
Dot11ExtSetUnicastCipherAlgorithm x
Dot11ExtSetVirtualStationAPProperties x

IHV ハンドラー関数の詳細については、「ネイティブ 802.11 IHV ハンドラー関数」を参照してください。