Win32 API 日本語リファレンス
ホームNetworkManagement.WiFi › L2_NOTIFICATION_DATA

L2_NOTIFICATION_DATA

構造体
サイズx64: 40 バイト / x86: 32 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
NotificationSourceWLAN_NOTIFICATION_SOURCES4+0+0このメンバーは、通知の発生元を指定します。IHV Extensions DLL は、このメンバーに L2_NOTIFICATION_SOURCE_WLAN_IHV を設定しなければなりません。
NotificationCodeDWORD4+4+4このメンバーは、状態通知の通知コードを指定します。この通知コードには、ビット 0x10000 が設定されていてはなりません。
InterfaceGuidGUID16+8+8

ワイヤレス LAN (WLAN) アダプターのグローバル一意識別子 (GUID) です。

オペレーティング システムは、WLAN アダプターに関する GUID やその他のデータを、Dot11ExtIhvInitAdapter 関数の pDot11Adapter パラメーターを通じて渡します。この関数は、オペレーティング システムが WLAN アダプターの到着を検出したときに呼び出されます。この動作の詳細については、802.11 WLAN アダプターの到着を参照してください。

dwDataSizeDWORD4+24+24pData メンバーが参照するバッファー内のデータの長さ (バイト単位) です。通知に追加のデータが必要ない場合、IHV Extensions DLL はこのメンバーに 0 を設定しなければなりません。
pDatavoid*8/4+32+28

通知に関する追加のデータを格納する、呼び出し元が割り当てたバッファーのアドレスです。データの形式は、独立系ハードウェア ベンダー (IHV) が定義します。

通知に追加のデータが必要ない場合、IHV Extensions DLL はこのメンバーに NULL を設定しなければなりません。

公式ドキュメント

重要 ネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
L2_NOTIFICATION_DATA 構造体は、IHV Extensions DLL が、通知の登録を行ったサービスまたはアプリケーションに通知を送信するために使用します。

解説(Remarks)

アプリケーションまたはサービスは、Auto Configuration Manager (ACM) の関数である WlanRegisterNotification を呼び出して、通知を受け取るための登録を行います。この関数の詳細については、Microsoft Windows SDK のドキュメントを参照してください。

IHV Extensions DLL は、Dot11ExtSendNotification 関数を呼び出して、登録済みのサービスまたはアプリケーションに通知を送信します。サービスまたはアプリケーションは、L2_NOTIFICATION_SOURCE_WLAN_IHV のソースからの通知を受け取るように登録しなければなりません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// L2_NOTIFICATION_DATA  (x64 40 / x86 32 バイト)
typedef struct L2_NOTIFICATION_DATA {
    WLAN_NOTIFICATION_SOURCES NotificationSource;
    DWORD NotificationCode;
    GUID InterfaceGuid;
    DWORD dwDataSize;
    void* pData;
} L2_NOTIFICATION_DATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct L2_NOTIFICATION_DATA
{
    public uint NotificationSource;
    public uint NotificationCode;
    public Guid InterfaceGuid;
    public uint dwDataSize;
    public IntPtr pData;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure L2_NOTIFICATION_DATA
    Public NotificationSource As UInteger
    Public NotificationCode As UInteger
    Public InterfaceGuid As Guid
    Public dwDataSize As UInteger
    Public pData As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class L2_NOTIFICATION_DATA(ctypes.Structure):
    _fields_ = [
        ("NotificationSource", wintypes.DWORD),
        ("NotificationCode", wintypes.DWORD),
        ("InterfaceGuid", GUID),
        ("dwDataSize", wintypes.DWORD),
        ("pData", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct L2_NOTIFICATION_DATA {
    pub NotificationSource: u32,
    pub NotificationCode: u32,
    pub InterfaceGuid: GUID,
    pub dwDataSize: u32,
    pub pData: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type L2_NOTIFICATION_DATA struct {
	NotificationSource uint32
	NotificationCode uint32
	InterfaceGuid windows.GUID
	dwDataSize uint32
	pData uintptr
}
type
  L2_NOTIFICATION_DATA = record
    NotificationSource: DWORD;
    NotificationCode: DWORD;
    InterfaceGuid: TGUID;
    dwDataSize: DWORD;
    pData: Pointer;
  end;
const L2_NOTIFICATION_DATA = extern struct {
    NotificationSource: u32,
    NotificationCode: u32,
    InterfaceGuid: GUID,
    dwDataSize: u32,
    pData: ?*anyopaque,
};
type
  L2_NOTIFICATION_DATA {.bycopy.} = object
    NotificationSource: uint32
    NotificationCode: uint32
    InterfaceGuid: GUID
    dwDataSize: uint32
    pData: pointer
struct L2_NOTIFICATION_DATA
{
    uint NotificationSource;
    uint NotificationCode;
    GUID InterfaceGuid;
    uint dwDataSize;
    void* pData;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; L2_NOTIFICATION_DATA サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; NotificationSource : WLAN_NOTIFICATION_SOURCES (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; NotificationCode : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; InterfaceGuid : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; dwDataSize : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pData : void* (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; L2_NOTIFICATION_DATA サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; NotificationSource : WLAN_NOTIFICATION_SOURCES (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; NotificationCode : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; InterfaceGuid : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; dwDataSize : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pData : void* (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global L2_NOTIFICATION_DATA
    #field int NotificationSource
    #field int NotificationCode
    #field GUID InterfaceGuid
    #field int dwDataSize
    #field intptr pData
#endstruct

stdim st, L2_NOTIFICATION_DATA        ; NSTRUCT 変数を確保
st->NotificationSource = 100
mes "NotificationSource=" + st->NotificationSource