Share via

WLAN_INTF_OPCODE 列挙 (wlanapi.h)

  • [アーティクル]

重要

一部の情報はプレリリース製品に関連しており、商用リリース前に大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ワイヤレス インターフェイスのパラメーターの設定とクエリに使用されるさまざまなオペコードを指定する定数を定義します。 これらの定数は、ワイヤレス インターフェイスでパラメーターを照会または設定するために、OpCode パラメーターを WlanQueryInterface 関数と WlanSetInterface 関数に渡すことができる可能性のあるオペコードを表します。

構文

typedef enum _WLAN_INTF_OPCODE {
  wlan_intf_opcode_autoconf_start = 0x000000000,
  wlan_intf_opcode_autoconf_enabled,
  wlan_intf_opcode_background_scan_enabled,
  wlan_intf_opcode_media_streaming_mode,
  wlan_intf_opcode_radio_state,
  wlan_intf_opcode_bss_type,
  wlan_intf_opcode_interface_state,
  wlan_intf_opcode_current_connection,
  wlan_intf_opcode_channel_number,
  wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs,
  wlan_intf_opcode_supported_adhoc_auth_cipher_pairs,
  wlan_intf_opcode_supported_country_or_region_string_list,
  wlan_intf_opcode_current_operation_mode,
  wlan_intf_opcode_supported_safe_mode,
  wlan_intf_opcode_certified_safe_mode,
  wlan_intf_opcode_hosted_network_capable,
  wlan_intf_opcode_management_frame_protection_capable,
  wlan_intf_opcode_secondary_sta_interfaces,
  wlan_intf_opcode_secondary_sta_synchronized_connections,
  wlan_intf_opcode_realtime_connection_quality,
  wlan_intf_opcode_qos_info,
  wlan_intf_opcode_autoconf_end = 0x0fffffff,
  wlan_intf_opcode_msm_start = 0x10000100,
  wlan_intf_opcode_statistics,
  wlan_intf_opcode_rssi,
  wlan_intf_opcode_msm_end = 0x1fffffff,
  wlan_intf_opcode_security_start = 0x20010000,
  wlan_intf_opcode_security_end = 0x2fffffff,
  wlan_intf_opcode_ihv_start = 0x30000000,
  wlan_intf_opcode_ihv_end = 0x3fffffff
} WLAN_INTF_OPCODE, *PWLAN_INTF_OPCODE;

定数

 
wlan_intf_opcode_autoconf_start
値: 0x000000000
使用されていません。
wlan_intf_opcode_autoconf_enabled
自動構成が有効になっているかどうかを設定またはクエリするために使用されるオペコード。
wlan_intf_opcode_background_scan_enabled
バックグラウンド スキャンが有効になっているかどうかを設定またはクエリするために使用されるオペコード。

バックグラウンド スキャンは、インターフェイスが接続状態の場合にのみ無効にすることができます。 少なくとも 1 つのクライアントで無効にされた場合、バックグラウンド スキャンは無効になります。
インターフェイスが切断されると、バックグラウンド スキャンが自動的に有効になります。
wlan_intf_opcode_media_streaming_mode
ドライバーのメディア ストリーミング モードの設定またはクエリに使用されるオペコード。

メディア ストリーミング モードは、インターフェイスが接続状態の場合にのみ設定できます。 メディア ストリーミング モードは、少なくとも 1 つのクライアントで有効になっている場合に有効になります。 インターフェイスが切断されると、メディア ストリーミング モードは自動的に無効になります
wlan_intf_opcode_radio_state
無線状態の設定またはクエリに使用されるオペコード。
wlan_intf_opcode_bss_type
インターフェイスの BSS 型の設定またはクエリに使用されるオペコード。
wlan_intf_opcode_interface_state
インターフェイスの状態のクエリに使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_current_connection
インターフェイスの現在の接続に関する情報のクエリに使用されるオペコード。

このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。 インターフェイスが切断または切断状態の場合、 WlanQueryInterface 関数は ERROR_INVALID_STATEを返します。
wlan_intf_opcode_channel_number
ワイヤレス インターフェイスが動作している現在のチャネルのクエリに使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs
インフラストラクチャ モードでサポートされている認証と暗号のペアに対してクエリを実行するために使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_supported_adhoc_auth_cipher_pairs
アドホック モードでサポートされている認証と暗号のペアに対してクエリを実行するために使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_supported_country_or_region_string_list
サポートされている国または地域の文字列の一覧のクエリに使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_current_operation_mode
ワイヤレス インターフェイスの現在の動作モードの設定またはクエリに使用されるオペコード。 操作モードの詳細については、「 ネイティブ 802.11 操作モード」を参照してください。
wlan_intf_opcode_supported_safe_mode
ミニポートと NIC の組み合わせが連邦情報処理標準 (FIPS) モードをサポートしているかどうかを照会するために使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。 FIPS モードはセーフ モードとも呼ばれます。 このワイヤレス セーフ モードは、オペレーティング システムのセーフ モードとは異なります。
wlan_intf_opcode_certified_safe_mode
ミニポートと NIC の組み合わせが FIPS 認定かどうかを照会するために使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_hosted_network_capable
ワイヤレス インターフェイスに関連付けられているデバイス ドライバーでホストネットワークサポートのクエリを実行するために使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。

クエリによってこのオペコードに対して返されるデータ型はブール値です。 TRUE の値は、Hosted Network がサポートされていることを示します。 FALSE の値は、ホストされているネットワークがサポートされていないことを示します。

この値は、ワイヤレス LAN サービスがインストールされている Windows 7 および Windows Server 2008 R2 上のワイヤレス ホステッド ネットワークをサポートするために追加されたネイティブ ワイヤレス API の拡張機能です。
wlan_intf_opcode_management_frame_protection_capable
ワイヤレス インターフェイスに関連付けられているデバイス ドライバーで管理フレーム保護 (複合機) がサポートされているかどうかを照会するために使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。

複合機は、802.11 標準への IEEE 802.11w-2009 修正で定義されています。

この値は、Windows 8 および Windows Server 2012 でサポートされています。
wlan_intf_opcode_secondary_sta_interfaces
クライアントが特定のインターフェイスのセカンダリ STA に関する情報を照会できるようにします。 指定されたインターフェイス上のセカンダリ STA の WLAN_INTERFACE_INFO_LIST を返します。
wlan_intf_opcode_secondary_sta_synchronized_connections
指定したインターフェイスでセカンダリ STA 同期接続が有効になっているかどうかを照会するために使用されるオペコード。
wlan_intf_opcode_realtime_connection_quality
クライアントが特定のインターフェイス上の接続の品質を記述する属性に対してクエリを実行できるようにするオペコード。 この API は、他のさまざまな既存の WLAN API (wlan_intf_opcode_current_connection と WlanGetNetworkBssList) のフィールドを組み合わせますが、場所に依存する情報は省略されるため、場所アクセス特権は必要ありません。

このオペコードは、指定されたインターフェイス上の接続の品質を記述する属性を含む構造体を取得します。 インターフェイスが接続されていない場合は失敗します。 アプリはこの API を使用して、WiFi 接続の状態と品質に関する情報を取得できます (API には、ストリーミング、ビデオ会議、その他のネットワーク品質に依存する操作へのアプリケーションがあります)。 現在 、wlan_intf_opcode_current_connection と WlanGetNetworkBssList を使用して接続品質情報を取得しているが、場所へのアクセスを要求する必要がないアプリでは、この API を使用できます。

詳細については、 WLAN_REALTIME_CONNECTION_QUALITYのコード例を参照してください。
wlan_intf_opcode_qos_info
クライアントが Wi-Fi Alliance の Wi-Fi QoS 管理仕様で概説され、802.11 仕様で定義されているサービス品質 (QoS) 機能の状態を照会できるようにするオペコード。

このオペコードは、 WFA の Wi-Fi QoS 管理仕様で概説され、 802.11 仕様で定義されている 4 つの機能に関する情報を含む構造体を取得します。アプリはこの API を使用して、デバイスの WFA QoS 機能に関する情報を取得し、接続されている場合は、そのピアの WFA QoS 機能と、現在の接続用に構成されている WFA QoS 機能の状態を取得できます。 QoS2 またはその他の QoS API を現在使用しているアプリは、これを使用して、パフォーマンス テレメトリまたは UI 表示の目的で追加の QoS 情報を取得できます。 この API を使用して動作の変更を通知することは、その主な目的ではありません。

詳細については、 WLAN_QOS_INFOのコード例を参照してください。
wlan_intf_opcode_autoconf_end
値: 0x0fffffff
使用されていません。
wlan_intf_opcode_msm_start
値: 0x10000100
使用されていません。
wlan_intf_opcode_statistics
ドライバーの統計情報のクエリに使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_rssi
受信した信号強度のクエリに使用されるオペコード。 このオペコードは、 WlanQueryInterface 関数を使用したクエリ操作でのみ使用できます。
wlan_intf_opcode_msm_end
値: 0x1fffffff
使用されていません。
wlan_intf_opcode_security_start
値: 0x20010000
使用されていません。
wlan_intf_opcode_security_end
値: 0x2fffffff
使用されていません。
wlan_intf_opcode_ihv_start
値: 0x30000000
使用されていません。
wlan_intf_opcode_ihv_end
値: 0x3fffffff
使用しません。

必要条件

要件 値
Header wlanapi.h

こちらもご覧ください