ホーム › NetworkManagement.WindowsNetworkVirtualization › WNV_NOTIFICATION_PARAM
WNV_NOTIFICATION_PARAM
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Header | WNV_OBJECT_HEADER | 8 | +0 | +0 | この構造体のバージョンとバッファーサイズです。 | ||||||||
| NotificationType | WNV_NOTIFICATION_TYPE | 4 | +8 | +8 | 要求する通知の種類を指定する WNV_NOTIFICATION_TYPE 列挙型の値です。ポリシーの不一致、インターネット制御メッセージ プロトコル (ICMP) リダイレクト メッセージの到着、オブジェクトの変更などがあります。 | ||||||||
| PendingNotifications | DWORD | 4 | +12 | +12 | 指定された種類の保留中のイベント数に関する情報を呼び出し元に提供する出力値です。保留中のイベントは、現在の WnvRequestNotification 関数の呼び出しが完了した時点で Buffer フィールドに既に追加済みのイベントと共に、WNV ドライバー内でキューに格納されます。このフィールドによって、WNV ドライバーは残りのイベント数を WnvRequestNotification の呼び出し元に通知できるため、呼び出し元は必要なバッファーのサイズを見積もることができます。呼び出し元は、これらの残りのイベントを受け取るために、十分なバッファーサイズを指定して WnvRequestNotification を再度呼び出してください。 | ||||||||
| Buffer | BYTE* | 8/4 | +16 | +16 | WnvRequestNotification の呼び出しが完了するときに、指定された種類の通知構造体が WNV ドライバーによって格納されるバッファーへのポインターです。このフィールドに最終的に格納される内容は、次の表のとおりです。
|
公式ドキュメント
WnvRequestNotification 関数の呼び出しにおけるバージョン、通知の種類、およびバッファーの場所を指定します。この構造体で指定されたバッファーには、指定された種類の通知が利用可能になったときに Windows Network Virtualization (WNV) ドライバーによって内容が格納されます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// WNV_OBJECT_HEADER (x64 8 / x86 8 バイト)
typedef struct WNV_OBJECT_HEADER {
BYTE MajorVersion;
BYTE MinorVersion;
DWORD Size;
} WNV_OBJECT_HEADER;
// WNV_NOTIFICATION_PARAM (x64 24 / x86 20 バイト)
typedef struct WNV_NOTIFICATION_PARAM {
WNV_OBJECT_HEADER Header;
WNV_NOTIFICATION_TYPE NotificationType;
DWORD PendingNotifications;
BYTE* Buffer;
} WNV_NOTIFICATION_PARAM;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WNV_OBJECT_HEADER
{
public byte MajorVersion;
public byte MinorVersion;
public uint Size;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WNV_NOTIFICATION_PARAM
{
public WNV_OBJECT_HEADER Header;
public int NotificationType;
public uint PendingNotifications;
public IntPtr Buffer;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WNV_OBJECT_HEADER
Public MajorVersion As Byte
Public MinorVersion As Byte
Public Size As UInteger
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WNV_NOTIFICATION_PARAM
Public Header As WNV_OBJECT_HEADER
Public NotificationType As Integer
Public PendingNotifications As UInteger
Public Buffer As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class WNV_OBJECT_HEADER(ctypes.Structure):
_fields_ = [
("MajorVersion", ctypes.c_ubyte),
("MinorVersion", ctypes.c_ubyte),
("Size", wintypes.DWORD),
]
class WNV_NOTIFICATION_PARAM(ctypes.Structure):
_fields_ = [
("Header", WNV_OBJECT_HEADER),
("NotificationType", ctypes.c_int),
("PendingNotifications", wintypes.DWORD),
("Buffer", ctypes.c_void_p),
]#[repr(C)]
pub struct WNV_OBJECT_HEADER {
pub MajorVersion: u8,
pub MinorVersion: u8,
pub Size: u32,
}
#[repr(C)]
pub struct WNV_NOTIFICATION_PARAM {
pub Header: WNV_OBJECT_HEADER,
pub NotificationType: i32,
pub PendingNotifications: u32,
pub Buffer: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type WNV_OBJECT_HEADER struct {
MajorVersion byte
MinorVersion byte
Size uint32
}
type WNV_NOTIFICATION_PARAM struct {
Header WNV_OBJECT_HEADER
NotificationType int32
PendingNotifications uint32
Buffer uintptr
}type
WNV_OBJECT_HEADER = record
MajorVersion: Byte;
MinorVersion: Byte;
Size: DWORD;
end;
WNV_NOTIFICATION_PARAM = record
Header: WNV_OBJECT_HEADER;
NotificationType: Integer;
PendingNotifications: DWORD;
Buffer: Pointer;
end;const WNV_OBJECT_HEADER = extern struct {
MajorVersion: u8,
MinorVersion: u8,
Size: u32,
};
const WNV_NOTIFICATION_PARAM = extern struct {
Header: WNV_OBJECT_HEADER,
NotificationType: i32,
PendingNotifications: u32,
Buffer: ?*anyopaque,
};type
WNV_OBJECT_HEADER {.bycopy.} = object
MajorVersion: uint8
MinorVersion: uint8
Size: uint32
WNV_NOTIFICATION_PARAM {.bycopy.} = object
Header: WNV_OBJECT_HEADER
NotificationType: int32
PendingNotifications: uint32
Buffer: pointerstruct WNV_OBJECT_HEADER
{
ubyte MajorVersion;
ubyte MinorVersion;
uint Size;
}
struct WNV_NOTIFICATION_PARAM
{
WNV_OBJECT_HEADER Header;
int NotificationType;
uint PendingNotifications;
void* Buffer;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; WNV_NOTIFICATION_PARAM サイズ: 20 バイト(x86)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; Header : WNV_OBJECT_HEADER (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; NotificationType : WNV_NOTIFICATION_TYPE (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; PendingNotifications : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Buffer : BYTE* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WNV_NOTIFICATION_PARAM サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; Header : WNV_OBJECT_HEADER (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; NotificationType : WNV_NOTIFICATION_TYPE (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; PendingNotifications : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Buffer : BYTE* (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global WNV_OBJECT_HEADER
#field byte MajorVersion
#field byte MinorVersion
#field int Size
#endstruct
#defstruct global WNV_NOTIFICATION_PARAM
#field WNV_OBJECT_HEADER Header
#field int NotificationType
#field int PendingNotifications
#field intptr Buffer
#endstruct
stdim st, WNV_NOTIFICATION_PARAM ; NSTRUCT 変数を確保
st->NotificationType = 100
mes "NotificationType=" + st->NotificationType