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

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバー モデル」を参照してください。
 
オペレーティング システムは Dot11ExtIhvInitService 関数を呼び出して、IHV 拡張機能 DLL と、オペレーティング システムと DLL の間の API インターフェイスを初期化します。

構文

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

パラメーター

[in] dwVerNumUsed

オペレーティング システムで使用されるインターフェイスのバージョン。 このパラメーターの値は、 の pDot11IHVVersionInfo パラメーターで返されるバージョン番号の範囲の間である必要があります。 Dot11ExtIhvGetVersionInfo IHV ハンドラー関数。

[in] pDot11ExtAPI

オペレーティング システムでサポートされている IHV 拡張機能のアドレスを含む、 DOT11EXT_APIS 構造体へのポインター。 オペレーティング システムは、 Dot11ExtIhvInitService 関数の呼び出しを行う前に、このパラメーターを関数アドレスで書式設定します。

pvReserved

このパラメーターは、オペレーティング システムで使用するために予約されています。

[out] pDot11IHVHandlers

IHV 拡張機能 DLL でサポートされている IHV ハンドラー関数のアドレスを含む、DOT11EXT_IHV_HANDLERS構造体へのポインター。 DLL は 、Dot11ExtIhvInitService 関数の呼び出しから戻る前に、このパラメーターを関数アドレスで書式設定します。

戻り値

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

注釈

オペレーティング システムは、 の呼び出しの直後に Dot11ExtIhvInitService 関数を呼び出します。 Dot11ExtIhvGetVersionInfo 関数。 呼び出されると、 Dot11ExtIhvInitService は、必要に応じて IHV 拡張機能 DLL を初期化する必要があります。 関数が戻るときに、IHV ハンドラー関数への追加の呼び出しを受け入れるように DLL を準備する必要があります。

pDot11IHVHandlers パラメーターを使用してアドレスが解決される他の IHV 拡張機能およびハンドラー関数の処理方法とは異なり、オペレーティング システムは GetProcAddress 関数を呼び出して Dot11ExtIhvInitService 関数のアドレスを解決します。 その結果、IHV 拡張機能 DLL の開発者は、次のガイドラインに従う必要があります。

  • DLL には、このトピックで説明する形式の Dot11ExtIhvInitService という名前の関数を実装する必要があります。
  • IHV 拡張機能 DLL のビルドに使用されるソース モジュール定義 (.def) ファイルの EXPORTS ステートメントには、 Dot11ExtIhvInitService 関数の関数名エントリが含まれている必要があります。
GetProcAddress の詳細については、Microsoft Windows SDKドキュメントを参照してください。

要件

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

こちらもご覧ください

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo