次の方法で共有


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

重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
 
オペレーティング システムは、接続状態が変化するたびに、Dot11ExtIhvQueryUIRequest 関数を呼び出します。 この関数が呼び出されると、IHV 拡張機能 DLL は、オペレーティング システムが UI 要求に使用できる DOT11EXT_IHV_UI_REQUEST 構造体を返します。

構文

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

パラメーター

[in, optional] hIhvExtAdapter

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

[in] connectionPhase

現在の接続フェーズ。 このメンバーのデータ型は、DOT11EXT_IHV_CONNECTION_PHASE 列挙型です。

connection_phase_any

接続フェーズを指定します。

connection_phase_initial_connection

IHV 拡張機能 DLL が事前関連付け操作を開始する前の接続フェーズを指定します。 事前関連付け操作の詳細については、「関連付け前操作の」を参照してください。

connection_phase_post_l3_connection

IHV 拡張機能 DLL が関連付け後の操作を完了した後の接続フェーズを指定します。 関連付け後操作の詳細については、「関連付け後操作 を参照してください。

[out] ppIhvUIRequest

DOT11EXT_IHV_UI_REQUEST 構造体へのポインターのアドレス。 IHV 拡張機能 DLL は、Dot11ExtAllocateBuffer 呼び出すことによって、DOT11EXT_IHV_UI_REQUEST構造体のバッファーを割り当てる必要があります。

戻り値

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

備考

Dot11ExtIhvQueryUIRequest 呼び出されると、IHV 拡張機能 DLL は、DOT11EXT_IHV_UI_REQUEST 構造体として書式設定されたバッファーを割り当てて返す必要があります。 このような場合、DLL は次のガイドラインに従う必要があります。

  • IHV 拡張機能 DLL は、バッファー 割り当てるために Dot11ExtAllocateBuffer を呼び出す必要があります。 DLL が Dot11ExtIhvQueryUIRequest から戻った後、オペレーティング システムは Dot11ExtFreeBuffer を呼び出してバッファーを解放する役割を担います。
  • IHV 拡張機能 DLL は、接続状態の変更に適した UI 要求の DOT11EXT_IHV_UI_REQUEST 構造を書式設定します。

    たとえば、connectionPhaseconnection_phase_initial_connectionに設定されている場合、IHV 拡張機能 DLL は、接続操作の開始をユーザーに通知するユーザー インターフェイス ページを参照するように、DOT11EXT_IHV_UI_REQUEST構造体のメンバーを設定できます。

必要条件

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

関連項目

Dot11ExtAllocateBuffer

DOT11EXT_IHV_UI_REQUEST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer