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

[アーティクル]
02/07/2025

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

オペレーティングシステムは、Dot11ExtIhvPerformCapabilityMatch 関数呼び出して、検出された基本サービスセット (BSS) ネットワークが IHV によって定義された接続およびセキュリティプロファイル拡張機能と一致するかどうかを IHV 拡張機能 DLL が判断するように要求します。

構文

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

DWORD Dot11extihvPerformCapabilityMatch(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

パラメーター

[in, optional] hIhvExtAdapter

ワイヤレス LAN (WLAN) アダプターを参照するために IHV 拡張機能 DLL によって使用されるハンドル。このハンドル値は、Dot11ExtIhvInitAdapter IHV ハンドラー関数への以前の呼び出しによって指定されました。

[in, optional] pIhvProfileParams

へのポインター DOT11EXT_IHV_PROFILE_PARAMS 構造体。この構造体は、プロファイル拡張機能を適用する基本サービスセット (BSS) ネットワークの属性を定義します。

[in] pIhvConnProfile

へのポインター DOT11EXT_IHV_CONNECTIVITY_PROFILE IHV プロファイルの接続設定を含む構造体です。

[in] pIhvSecProfile

へのポインター DOT11EXT_IHV_SECURITY_PROFILE IHV プロファイルのセキュリティ設定を含む構造体です。

[in, optional] pConnectableBssid

BSS ネットワークから受信した 1 つ以上の 802.11 ビーコンまたはプローブ応答フレームを含む、DOT11_BSS_LIST 構造体へのポインター。このリストは、WLAN アダプターによって実行された最後のスキャン操作の結果から派生します。スキャン操作の詳細については、「Native 802.11 Scan Operations」を参照してください。

注 Windows Vista の場合、IHV 拡張機能 DLL では、インフラストラクチャ基本サービスセット (BSS) ネットワークのみがサポートされます。

[out] pdwReasonCode

Dot11ExtIhvPerformCapabilityMatch 関数の戻り値に関する追加情報を提供する DWORD 値へのポインター。 IHV 拡張機能 DLL では、* pdwReasonCode を L2cmn.h で定義されているL2_REASON_CODE_xxxx値に設定する必要があります。

戻り値

802.11 ビーコンフレームとプローブ応答フレームの一覧のすべてのエントリが、プロファイルフラグメントで定義されている接続属性とセキュリティ属性をサポートしている場合、この関数はERROR_SUCCESSを返します。それ以外の場合は、Winerror.h で定義されているエラーコードが返されます。

備考

WLAN アダプターが範囲内の BSS ネットワークを検出するスキャン操作を完了した後、オペレーティングシステムは、Dot11ExtIhvPerformCapabilityMatch 関数を呼び出して、検出された BSS ネットワークのいずれかが IHV によって定義された接続またはセキュリティプロファイル拡張機能と一致するかどうかを判断する可能性があります。

Dot11ExtIhvPerformCapabilityMatch 関数が呼び出されると、IHV Extensions DLL は次のガイドラインに従う必要があります。

IHV 拡張機能 DLL がプロファイルフラグメントと一致する IEEE 802.11 ビーコンまたはプローブ応答フレームを少なくとも 1 つ検出した場合は、* pdwReasonCode を次のいずれかに設定する必要があります。
- L2_REASON_CODE_SUCCESS。
- L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
このような状況では、dot11ExtIhvPerformCapabilityMatch 関数はERROR_SUCCESSを返す必要があります。
IHV 拡張機能 DLL でプロファイルフラグメントに一致する IEEE 802.11 ビーコンまたはプローブ応答フレームが見つからない場合は、*pdwReasonCode L2_REASON_CODE_SUCCESSに設定しないでください。代わりに、DLL で * pdwReasonCode を次のいずれかに設定する必要があります。
- 適切なL2_REASON_CODE_xxxxエラー値。
- L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
このような状況では、Dot11ExtIhvPerformCapabilityMatch 関数はERROR_SUCCESSを返す必要があります。

Native 802.11 XML スキーマの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
ターゲットプラットフォームの	デスクトップ
ヘッダー	wlanihv.h (Wlanihv.h、Winclient.h、L2cmn.h を含む)

次の方法で共有

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

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース