Win32 API 日本語リファレンス
ホームUI.Shell › NOTIFYICONDATAA

NOTIFYICONDATAA

構造体
サイズx64: 520 バイト / x86: 508 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。
hWndHWND8/4+4+4通知領域のアイコンに関連付けられた通知を受け取るウィンドウへのハンドル。
uIDDWORD4+12+8タスクバーアイコンのアプリケーション定義の識別子。Shell_NotifyIcon が呼び出されたとき、シェルは (hWnduID の組み合わせ) または guidItem のいずれかを使用して、どのアイコンを操作するかを識別します。それぞれに異なる uID を割り当てることで、1 つの hWnd に複数のアイコンを関連付けることができます。guidItem が指定されている場合、uID は無視されます。
uFlagsNOTIFY_ICON_DATA_FLAGS4+16+12

構造体の他のメンバーのうちどれが有効なデータを含んでいるかを示すか、またはツールチップの表示方法に関する追加情報を提供するフラグ。このメンバーには次の値の組み合わせを指定できます。

NIF_MESSAGE (0x00000001)

0x00000001。uCallbackMessage メンバーが有効です。

NIF_ICON (0x00000002)

0x00000002。hIcon メンバーが有効です。

NIF_TIP (0x00000004)

0x00000004。szTip メンバーが有効です。

NIF_STATE (0x00000008)

0x00000008。dwState メンバーと dwStateMask メンバーが有効です。

NIF_INFO (0x00000010)

0x00000010。バルーン通知を表示します。szInfoszInfoTitledwInfoFlagsuTimeout の各メンバーが有効です。uTimeout は Windows 2000 と Windows XP でのみ有効であることに注意してください。

  • バルーン通知を表示するには、NIF_INFO を指定し、szInfo にテキストを設定します。
  • バルーン通知を削除するには、NIF_INFO を指定し、szInfo に空の文字列を設定します。
  • 通知を表示せずに通知領域アイコンを追加するには、NIF_INFO フラグを設定しません。

NIF_GUID (0x00000020)

0x00000020。

  • Windows 7 以降: guidItem が有効です。
  • Windows Vista 以前: 予約済みです。

NIF_REALTIME (0x00000040)

0x00000040。Windows Vista 以降。バルーン通知をすぐに表示できない場合は破棄します。後で表示すると意味がなくなる、または誤解を招くようなリアルタイム情報を表す通知に、このフラグを使用します。たとえば「電話が鳴っています。」というメッセージなどです。NIF_REALTIMENIF_INFO フラグと組み合わせた場合にのみ意味を持ちます。

NIF_SHOWTIP (0x00000080)

0x00000080。Windows Vista 以降。標準のツールチップを使用します。通常、uVersionNOTIFYICON_VERSION_4 が設定されている場合、標準のツールチップは抑制され、アプリケーションが描画するポップアップ UI に置き換えることができます。NOTIFYICON_VERSION_4 で標準のツールチップを表示したい場合は、NIF_SHOWTIP を指定して、標準のツールチップを引き続き表示することを示すことができます。

uCallbackMessageDWORD4+20+16

アプリケーション定義のメッセージ識別子。システムはこの識別子を使用して、hWnd で指定されたウィンドウに通知メッセージを送信します。これらの通知メッセージは、アイコンの外接矩形内でマウスイベントやホバーが発生したとき、キーボードでアイコンが選択またはアクティブ化されたとき、あるいはバルーン通知内でそれらの操作が発生したときに送信されます。

uVersion メンバーが 0 または NOTIFYICON_VERSION の場合、メッセージの wParam パラメーターには、イベントが発生したタスクバーアイコンの識別子が格納されます。この識別子の長さは 32 ビットになることがあります。lParam パラメーターには、イベントに関連付けられたマウスまたはキーボードのメッセージが格納されます。たとえば、ポインターがタスクバーアイコンの上に移動すると、lParam には WM_MOUSEMOVE が設定されます。

uVersion メンバーが NOTIFYICON_VERSION_4 の場合、アプリケーションは引き続き uCallbackMessage メンバーを通じてアプリケーション定義のメッセージという形で通知イベントを受け取りますが、そのメッセージの lParam パラメーターと wParam パラメーターの解釈は次のように変更されます。

  • LOWORD(lParam) には、NIN_BALLOONSHOWNIN_POPUPOPENWM_CONTEXTMENU などの通知イベントが格納されます。
  • HIWORD(lParam) にはアイコン ID が格納されます。アイコン ID の長さは 16 ビットに制限されます。
  • GET_X_LPARAM(wParam) は、通知イベント NIN_POPUPOPENNIN_SELECT、NIN_KEYSELECT、および WM_MOUSEFIRST から WM_MOUSELAST までのすべてのマウスメッセージについて、X アンカー座標を返します。これらのメッセージがキーボードによって生成された場合、wParam には対象アイコンの左上隅が設定されます。その他のすべてのメッセージでは、wParam は未定義です。
  • GET_Y_LPARAM(wParam) は、X アンカーと同様に定義される通知イベントおよびメッセージについて、Y アンカー座標を返します。
hIconHICON8/4+24+20

追加、変更、または削除するアイコンへのハンドル。Windows XP 以降では、最大 32 BPP のアイコンをサポートします。

16x16 ピクセルのアイコンのみを指定した場合、高い dpi 値が設定されたシステムではより大きいサイズに拡大されます。これは見栄えの悪い結果につながる可能性があります。リソースファイルには 16x16 ピクセルのアイコンと 32x32 のアイコンの両方を用意することをお勧めします。正しいアイコンが読み込まれ、適切に拡大縮小されるように、LoadIconMetric を使用してください。コード例については「解説」を参照してください。

szTipCHAR128+32+24

標準のツールチップに表示するテキストを指定する、null で終わる文字列。終端の null 文字を含めて最大 64 文字です。

Windows 2000 以降では、szTip は終端の null 文字を含めて最大 128 文字を指定できます。

dwStateNOTIFY_ICON_STATE4+160+152

Windows 2000 以降。アイコンの状態。次の値のいずれか、または両方です。

NIS_HIDDEN (0x00000001)

0x00000001。アイコンは非表示です。

NIS_SHAREDICON (0x00000002)

0x00000002。アイコンリソースは複数のアイコンで共有されます。

dwStateMaskNOTIFY_ICON_STATE4+164+156Windows 2000 以降dwState メンバーのどのビットを取得または変更するかを指定する値。指定できる値は dwState と同じです。たとえば、このメンバーに NIS_HIDDEN を設定すると、項目の非表示状態だけが変更され、アイコン共有ビットはその値に関係なく無視されます。
szInfoCHAR256+168+160Windows 2000 以降。バルーン通知に表示するテキストを指定する、null で終わる文字列。終端の null 文字を含めて最大 256 文字ですが、ローカライズに対応できるよう英語では 200 文字以内に制限してください。UI からバルーン通知を削除するには、アイコンを削除する (NIM_DELETE) か、uFlagsNIF_INFO フラグを設定して szInfo を空の文字列にします。
Anonymous_Anonymous_e__Union4+424+416uTimeout と uVersion を共用する無名共用体。
szInfoTitleCHAR64+428+420Windows 2000 以降。バルーン通知のタイトルを指定する、null で終わる文字列。このタイトルは、テキストのすぐ上に大きなフォントで表示されます。終端の null 文字を含めて最大 64 文字ですが、ローカライズに対応できるよう英語では 48 文字以内に制限してください。
dwInfoFlagsNOTIFY_ICON_INFOTIP_FLAGS4+492+484

Windows 2000 以降。バルーン通知の動作と外観を変更するために設定できるフラグ。アイコンはタイトルの左側に配置されます。szInfoTitle メンバーの長さが 0 の場合、アイコンは表示されません。

NIIF_NONE (0x00000000)

0x00000000。アイコンなし。

NIIF_INFO (0x00000001)

0x00000001。情報アイコン。

NIIF_WARNING (0x00000002)

0x00000002。警告アイコン。

NIIF_ERROR (0x00000003)

0x00000003。エラーアイコン。

NIIF_USER (0x00000004)

0x00000004。Windows XP SP2 以降

  • Windows XP: hIcon で指定されたアイコンを、通知バルーンのタイトルアイコンとして使用します。
  • Windows Vista 以降: hBalloonIcon で指定されたアイコンを、通知バルーンのタイトルアイコンとして使用します。

NIIF_NOSOUND (0x00000010)

0x00000010。Windows XP 以降。関連付けられたサウンドを再生しません。通知にのみ適用されます。

NIIF_LARGE_ICON (0x00000020)

0x00000020。Windows Vista 以降。通知アイコンとして、アイコンの大きいバージョンを使用します。これは SM_CXICON x SM_CYICON のサイズのアイコンに対応します。このフラグが設定されていない場合は、SM_CXSMICON x SM_CYSMICON のサイズのアイコンが使用されます。

  • このフラグは、すべてのストックアイコンで使用できます。
  • 従来のカスタマイズされたアイコン (NIIF_USERhIcon) を使用するアプリケーションは、トレイアイコン (hIcon) に新しい SM_CXICON x SM_CYICON バージョンを用意する必要があります。これらのアイコンは、システムトレイまたはシステムコントロールエリア (SCA) に表示される際に縮小されます。
  • 新しいカスタマイズされたアイコン (NIIF_USERhBalloonIcon) は、指定するアイコン (hBalloonIcon) に SM_CXICON x SM_CYICON バージョンを用意する必要があります。

NIIF_RESPECT_QUIET_TIME (0x00000080)

0x00000080。Windows 7 以降。現在のユーザーが「クワイエットタイム」中の場合は、バルーン通知を表示しません。クワイエットタイムとは、新しいユーザーが自分のアカウントに初めてログオンしてからの最初の 1 時間のことです。この間、ほとんどの通知は送信または表示すべきではありません。これにより、ユーザーは煩わされることなく新しいコンピューターシステムに慣れることができます。クワイエットタイムは、オペレーティングシステムのアップグレードまたはクリーンインストールの後にも、各ユーザーに対して発生します。クワイエットタイム中にこのフラグを設定して送信された通知はキューに入れられず、表示されないまま破棄されます。アプリケーションは、その時点で通知がまだ有効であれば、後で再送信できます。

アプリケーションはクワイエットタイムにいつ遭遇するかを予測できないため、クワイエットタイムを尊重するアプリケーションでは、該当するすべての通知に対して常にこのフラグを設定することをお勧めします。

クワイエットタイム中でも、USB デバイスを接続したときやドキュメントを印刷したときなど、ユーザーの操作に対するフィードバックとしてユーザーが期待する特定の通知は、引き続き送信すべきです。

現在のユーザーがクワイエットタイム中でない場合、このフラグは効果がありません。

NIIF_ICON_MASK (0x0000000F)

0x0000000F。Windows XP 以降。予約済みです。

guidItemGUID16+496+488

Windows XP 以降

  • Windows 7 以降: アイコンを識別する、登録済みの GUID。この値は uID より優先され、アイコンを識別する推奨される方法です。uFlags メンバーに NIF_GUID フラグを設定する必要があります。
  • Windows XP および Windows Vista: 予約済みです。0 に設定しなければなりません。
アプリケーションを Windows Vista と Windows 7 の両方で実行する予定がある場合は、Windows のバージョンを確認し、Windows 7 以降の場合にのみ 0 以外の guidItem を指定することが不可欠です。

Shell_NotifyIcon のある呼び出しで通知アイコンを GUID で識別した場合、その同じアイコンを扱う以降の Shell_NotifyIcon の呼び出しでも、同じ GUID を使用してアイコンを識別する必要があります。

このメンバーで使用する GUID を生成するには、Guidgen.exe などの GUID 生成ツールを使用します。

hBalloonIconHICON8/4+512+504

Windows Vista 以降。通知領域アイコンとは独立して使用される、アプリケーションが提供するカスタマイズされた通知アイコンのハンドル。このメンバーが NULL 以外で、かつ dwInfoFlags メンバーに NIIF_USER フラグが設定されている場合、このアイコンが通知アイコンとして使用されます。このメンバーが NULL の場合は、従来の動作が行われます。

- uVersion.0

Windows 2000 より前の Windows バージョン向けに設計されたアプリケーションでは、この値を使用します。

- uVersion.NOTIFYICON_VERSION

Windows 2000 の動作を使用します。Windows 2000 以降向けに設計されたアプリケーションでは、この値を使用します。

- uVersion.NOTIFYICON_VERSION_4

現在の動作を使用します。Windows Vista 以降向けに設計されたアプリケーションでは、この値を使用します。

共用体: _Anonymous_e__Union x64 4B / x86 4B

フィールドサイズx64x86説明
uTimeoutDWORD4+0+0

Windows 2000 以降

注意 このメンバーは Windows Vista 以降では非推奨です。通知の表示時間は、現在ではシステムのアクセシビリティ設定に基づいて決まります。
uVersion との共用体です。通知のタイムアウト値 (ミリ秒単位)。システムは最小および最大のタイムアウト値を強制します。uTimeout に指定された値が大きすぎる場合は最大値に設定されます。小さすぎる値は既定で最小値になります。システムの最小および最大のタイムアウト値は、現在それぞれ 10 秒と 30 秒に設定されています。uTimeout の詳細については「解説」を参照してください。
uVersionDWORD4+0+0Windows 2000 以降uTimeout との共用体です (Windows Vista 以降では非推奨)。使用するシェル通知アイコンインターフェイスのバージョンを指定します。これらのバージョンの違いの詳細については、Shell_NotifyIcon を参照してください。このメンバーは、Shell_NotifyIcon を使用して NIM_SETVERSION メッセージを送信する場合にのみ使用されます。

公式ドキュメント

通知領域に通知を表示するためにシステムが必要とする情報を格納します。Shell_NotifyIcon で使用されます。

解説(Remarks)

通知の UI とコンテンツのベストプラクティスの詳細については、Windows ユーザーエクスペリエンス操作ガイドラインの「Notifications」を参照してください。

uFlags メンバーに NIF_INFO フラグを設定すると、バルーン形式の通知が使用されます。これらの通知の詳細については、バルーンツールチップを参照してください。

タスクバーには、一度に 1 つのバルーン通知しか表示できません。既に通知が表示されているときにアプリケーションが別の通知を表示しようとすると、新しい通知はキューに入れられ、古い通知が消えたときに表示されます。Windows Vista より前のバージョンの Windows では、元の通知の uTimeout 値に関係なく、既存の通知が少なくともシステムの最小タイムアウト時間だけ表示されるまで、新しい通知は表示されませんでした。ユーザーがコンピューターを使用していないと判断される場合、システムはこの時間をタイムアウトに算入しません。

この構造体のいくつかのメンバーは、Windows 2000 以降でのみサポートされます。これらのメンバーを有効にするには、ヘッダーに次の行のいずれかを含めます。

// Windows Vista and later:
#define NTDDI_VERSION NTDDI_WIN2K
#define NTDDI_VERSION NTDDI_WINXP
#define NTDDI_VERSION NTDDI_VISTA

// Windows XP and earlier:
#define _WIN32_IE 0x0500

この構造体は、そのサイズを設定して初期化しなければならないことに注意してください。現在定義されている構造体のサイズを使用すると、より小さい構造体を想定している以前のバージョンの Shell32.dll ではアプリケーションが動作しない可能性があります。適切なバージョン番号を定義すれば (シェルとコモンコントロールのバージョンを参照)、以前のバージョンの Shell32.dll に対してアプリケーションを実行できます。ただし、アプリケーションをより新しいシステムでも実行する必要がある場合は、これが問題を引き起こす可能性があります。

NOTIFYICONDATA 構造体のサイズを適切に設定すれば、現在のヘッダーファイルを使用しながら、すべてのバージョンの Shell32.dll との互換性を維持できます。構造体を初期化する前に、DllGetVersion を使用してシステムにインストールされている Shell32.dll のバージョンを判定し、cbSize を次の値のいずれかで初期化します。

Shell32.dll のバージョン cbSize
6.0.6 以降 (Windows Vista 以降) sizeof(NOTIFYICONDATA)
6.0 (Windows XP) NOTIFYICONDATA_V3_SIZE
5.0 (Windows 2000) NOTIFYICONDATA_V2_SIZE
5.0 より前のバージョン NOTIFYICONDATA_V1_SIZE

cbSize にこの値を使用することで、アプリケーションは以前のバージョンの Shell32.dll と互換性のある方法で NOTIFYICONDATA を使用できます。

次のコード例は、guidItem メンバーを使用するアプリケーションが Windows Vista と Windows 7 の両方で実行できるようにするための、バージョンチェックを示しています。オペレーティングシステムが Windows 7 の場合に TRUE を返すブール型の関数を提供します。この関数が TRUE を返さない限り、guidItem メンバーは 0 に設定しなければなりません。

注意 このコードは Windows 7 のバージョン番号に固有のものです。今後のバージョンの Windows および Windows Server も guidItem メンバーをサポートすると見込まれるため、その時点でこのコードを更新し、より新しいバージョン番号も有効と判定するようにする必要があります。
BOOL IsWin7OrLater()
{
    // Initialize the OSVERSIONINFOEX structure.
    OSVERSIONINFOEX osvi;
    ZeroMemory(&osvi, sizeof(OSVERSIONINFOEX));
    osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
    osvi.dwMajorVersion = 6;
    osvi.dwMinorVersion = 1;

    // Initialize the condition mask.
    DWORDLONG dwlConditionMask = 0;
    VER_SET_CONDITION(dwlConditionMask, VER_MAJORVERSION, VER_GREATER_EQUAL);
    VER_SET_CONDITION(dwlConditionMask, VER_MINORVERSION, VER_GREATER_EQUAL);

    // Perform the test.
    return VerifyVersionInfo(&osvi, 
                             VER_MAJORVERSION | VER_MINORVERSION,
                             dwlConditionMask);
}

次のコード例は、高 DPI で使用するアイコンを読み込むための LoadIconMetric の使用方法を示しています。

// Declare NOTIFYICONDATA details. 
// Error handling is omitted here for brevity. Do not omit it in your code.

NOTIFYICONDATA nid = {};
nid.cbSize = sizeof(nid);
nid.hWnd = hWnd;
nid.uFlags = NIF_ICON | NIF_TIP | NIF_GUID;

// Note: This is an example GUID only and should not be used.
// Normally, you should use a GUID-generating tool to provide the value to
// assign to guidItem.
static const GUID myGUID = 
    {0x23977b55, 0x10e0, 0x4041, {0xb8, 0x62, 0xb1, 0x95, 0x41, 0x96, 0x36, 0x69}};
nid.guidItem = myGUID;

// This text will be shown as the icon's tooltip.
StringCchCopy(nid.szTip, ARRAYSIZE(nid.szTip), L"Test application");

// Load the icon for high DPI.
LoadIconMetric(hInst, MAKEINTRESOURCE(IDI_SMALL), LIM_SMALL, &(nid.hIcon));

// Show the notification.
Shell_NotifyIcon(NIM_ADD, &nid) ? S_OK : E_FAIL;

トラブルシューティング

guidItem メンバーを使用してアイコンを識別している場合に、そのアイコンが表示されない、または Shell_NotifyIcon の一部の呼び出しが失敗するときは、次のいずれかが原因である可能性があります。
  1. Shell_NotifyIcon のすべての呼び出しで NIF_GUID フラグが設定されていない。Shell_NotifyIcon のある呼び出しで通知アイコンを GUID で識別したら、その同じアイコンを扱う以降の Shell_NotifyIcon の呼び出しでも、同じ GUID を使用してアイコンを識別する必要があります。
  2. アイコンを含むバイナリファイルが移動された。バイナリファイルのパスはアイコンの GUID の登録に含まれており、変更できません。アイコンに関連付けられた設定は、ファイルパスと GUID が変更されていない場合にのみ、アップグレードを通じて保持されます。パスを変更しなければならない場合、アプリケーションは既存のアイコンを登録したときに追加された GUID 情報をすべて削除する必要があります。その情報を削除すれば、バイナリファイルを新しい場所に移動し、新しい GUID で再登録できます。元の GUID 登録に関連付けられていた設定はすべて失われます。

    これは、サイドバイサイドインストールの場合にも発生します。サイドバイサイドインストールを扱う場合、アプリケーションの新しいバージョンではバイナリファイルの GUID を更新する必要があります。

    注意 ファイルの移動における唯一の例外は、移動前と移動後の両方のバイナリファイルが同じ会社によって Authenticode 署名されている場合です。その場合、設定は移動後も保持されます。
メモ

shellapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして NOTIFYICONDATA を定義します。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させて使用すると、不一致が生じ、コンパイルエラーや実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// NOTIFYICONDATAA  (x64 520 / x86 508 バイト)
#pragma pack(push, 1)
typedef struct NOTIFYICONDATAA {
    DWORD cbSize;
    HWND hWnd;
    DWORD uID;
    NOTIFY_ICON_DATA_FLAGS uFlags;
    DWORD uCallbackMessage;
    HICON hIcon;
    CHAR szTip[128];
    NOTIFY_ICON_STATE dwState;
    NOTIFY_ICON_STATE dwStateMask;
    CHAR szInfo[256];
    _Anonymous_e__Union Anonymous;
    CHAR szInfoTitle[64];
    NOTIFY_ICON_INFOTIP_FLAGS dwInfoFlags;
    GUID guidItem;
    HICON hBalloonIcon;
} NOTIFYICONDATAA;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct NOTIFYICONDATAA
{
    public uint cbSize;
    public IntPtr hWnd;
    public uint uID;
    public uint uFlags;
    public uint uCallbackMessage;
    public IntPtr hIcon;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 128)] public sbyte[] szTip;
    public uint dwState;
    public uint dwStateMask;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] public sbyte[] szInfo;
    public _Anonymous_e__Union Anonymous;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public sbyte[] szInfoTitle;
    public uint dwInfoFlags;
    public Guid guidItem;
    public IntPtr hBalloonIcon;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure NOTIFYICONDATAA
    Public cbSize As UInteger
    Public hWnd As IntPtr
    Public uID As UInteger
    Public uFlags As UInteger
    Public uCallbackMessage As UInteger
    Public hIcon As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=128)> Public szTip() As SByte
    Public dwState As UInteger
    Public dwStateMask As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=256)> Public szInfo() As SByte
    Public Anonymous As _Anonymous_e__Union
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=64)> Public szInfoTitle() As SByte
    Public dwInfoFlags As UInteger
    Public guidItem As Guid
    Public hBalloonIcon As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class NOTIFYICONDATAA(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("hWnd", ctypes.c_void_p),
        ("uID", wintypes.DWORD),
        ("uFlags", wintypes.DWORD),
        ("uCallbackMessage", wintypes.DWORD),
        ("hIcon", ctypes.c_void_p),
        ("szTip", ctypes.c_byte * 128),
        ("dwState", wintypes.DWORD),
        ("dwStateMask", wintypes.DWORD),
        ("szInfo", ctypes.c_byte * 256),
        ("Anonymous", _Anonymous_e__Union),
        ("szInfoTitle", ctypes.c_byte * 64),
        ("dwInfoFlags", wintypes.DWORD),
        ("guidItem", GUID),
        ("hBalloonIcon", ctypes.c_void_p),
    ]
#[repr(C, packed(1))]
pub struct NOTIFYICONDATAA {
    pub cbSize: u32,
    pub hWnd: *mut core::ffi::c_void,
    pub uID: u32,
    pub uFlags: u32,
    pub uCallbackMessage: u32,
    pub hIcon: *mut core::ffi::c_void,
    pub szTip: [i8; 128],
    pub dwState: u32,
    pub dwStateMask: u32,
    pub szInfo: [i8; 256],
    pub Anonymous: _Anonymous_e__Union,
    pub szInfoTitle: [i8; 64],
    pub dwInfoFlags: u32,
    pub guidItem: GUID,
    pub hBalloonIcon: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type NOTIFYICONDATAA struct {
	cbSize uint32
	hWnd uintptr
	uID uint32
	uFlags uint32
	uCallbackMessage uint32
	hIcon uintptr
	szTip [128]int8
	dwState uint32
	dwStateMask uint32
	szInfo [256]int8
	Anonymous _Anonymous_e__Union
	szInfoTitle [64]int8
	dwInfoFlags uint32
	guidItem windows.GUID
	hBalloonIcon uintptr
}
type
  NOTIFYICONDATAA = packed record
    cbSize: DWORD;
    hWnd: Pointer;
    uID: DWORD;
    uFlags: DWORD;
    uCallbackMessage: DWORD;
    hIcon: Pointer;
    szTip: array[0..127] of Shortint;
    dwState: DWORD;
    dwStateMask: DWORD;
    szInfo: array[0..255] of Shortint;
    Anonymous: _Anonymous_e__Union;
    szInfoTitle: array[0..63] of Shortint;
    dwInfoFlags: DWORD;
    guidItem: TGUID;
    hBalloonIcon: Pointer;
  end;
const NOTIFYICONDATAA = extern struct {
    cbSize: u32,
    hWnd: ?*anyopaque,
    uID: u32,
    uFlags: u32,
    uCallbackMessage: u32,
    hIcon: ?*anyopaque,
    szTip: [128]i8,
    dwState: u32,
    dwStateMask: u32,
    szInfo: [256]i8,
    Anonymous: _Anonymous_e__Union,
    szInfoTitle: [64]i8,
    dwInfoFlags: u32,
    guidItem: GUID,
    hBalloonIcon: ?*anyopaque,
};
type
  NOTIFYICONDATAA {.packed.} = object
    cbSize: uint32
    hWnd: pointer
    uID: uint32
    uFlags: uint32
    uCallbackMessage: uint32
    hIcon: pointer
    szTip: array[128, int8]
    dwState: uint32
    dwStateMask: uint32
    szInfo: array[256, int8]
    Anonymous: _Anonymous_e__Union
    szInfoTitle: array[64, int8]
    dwInfoFlags: uint32
    guidItem: GUID
    hBalloonIcon: pointer
align(1)
struct NOTIFYICONDATAA
{
    uint cbSize;
    void* hWnd;
    uint uID;
    uint uFlags;
    uint uCallbackMessage;
    void* hIcon;
    byte[128] szTip;
    uint dwState;
    uint dwStateMask;
    byte[256] szInfo;
    _Anonymous_e__Union Anonymous;
    byte[64] szInfoTitle;
    uint dwInfoFlags;
    GUID guidItem;
    void* hBalloonIcon;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NOTIFYICONDATAA サイズ: 508 バイト(x86)
dim st, 127    ; 4byte整数×127(構造体サイズ 508 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hWnd : HWND (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; uID : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; uFlags : NOTIFY_ICON_DATA_FLAGS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; uCallbackMessage : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; hIcon : HICON (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; szTip : CHAR (+24, 128byte)  varptr(st)+24 を基点に操作(128byte:入れ子/配列)
; dwState : NOTIFY_ICON_STATE (+152, 4byte)  st.38 = 値  /  値 = st.38   (lpoke/lpeek も可)
; dwStateMask : NOTIFY_ICON_STATE (+156, 4byte)  st.39 = 値  /  値 = st.39   (lpoke/lpeek も可)
; szInfo : CHAR (+160, 256byte)  varptr(st)+160 を基点に操作(256byte:入れ子/配列)
; Anonymous : _Anonymous_e__Union (+416, 4byte)  varptr(st)+416 を基点に操作(4byte:入れ子/配列)
; szInfoTitle : CHAR (+420, 64byte)  varptr(st)+420 を基点に操作(64byte:入れ子/配列)
; dwInfoFlags : NOTIFY_ICON_INFOTIP_FLAGS (+484, 4byte)  st.121 = 値  /  値 = st.121   (lpoke/lpeek も可)
; guidItem : GUID (+488, 16byte)  varptr(st)+488 を基点に操作(16byte:入れ子/配列)
; hBalloonIcon : HICON (+504, 4byte)  st.126 = 値  /  値 = st.126   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NOTIFYICONDATAA サイズ: 520 バイト(x64)
dim st, 130    ; 4byte整数×130(構造体サイズ 520 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hWnd : HWND (+4, 8byte)  qpoke st,4,値 / qpeek(st,4)  ※IronHSPのみ。3.7/3.8は lpoke st,4,下位 : lpoke st,8,上位
; uID : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; uFlags : NOTIFY_ICON_DATA_FLAGS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; uCallbackMessage : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; hIcon : HICON (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; szTip : CHAR (+32, 128byte)  varptr(st)+32 を基点に操作(128byte:入れ子/配列)
; dwState : NOTIFY_ICON_STATE (+160, 4byte)  st.40 = 値  /  値 = st.40   (lpoke/lpeek も可)
; dwStateMask : NOTIFY_ICON_STATE (+164, 4byte)  st.41 = 値  /  値 = st.41   (lpoke/lpeek も可)
; szInfo : CHAR (+168, 256byte)  varptr(st)+168 を基点に操作(256byte:入れ子/配列)
; Anonymous : _Anonymous_e__Union (+424, 4byte)  varptr(st)+424 を基点に操作(4byte:入れ子/配列)
; szInfoTitle : CHAR (+428, 64byte)  varptr(st)+428 を基点に操作(64byte:入れ子/配列)
; dwInfoFlags : NOTIFY_ICON_INFOTIP_FLAGS (+492, 4byte)  st.123 = 値  /  値 = st.123   (lpoke/lpeek も可)
; guidItem : GUID (+496, 16byte)  varptr(st)+496 を基点に操作(16byte:入れ子/配列)
; hBalloonIcon : HICON (+512, 8byte)  qpoke st,512,値 / qpeek(st,512)  ※IronHSPのみ。3.7/3.8は lpoke st,512,下位 : lpoke st,516,上位
; ※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 NOTIFYICONDATAA, pack=1
    #field int cbSize
    #field intptr hWnd
    #field int uID
    #field int uFlags
    #field int uCallbackMessage
    #field intptr hIcon
    #field byte szTip 128
    #field int dwState
    #field int dwStateMask
    #field byte szInfo 256
    #field byte Anonymous 4
    #field byte szInfoTitle 64
    #field int dwInfoFlags
    #field GUID guidItem
    #field intptr hBalloonIcon
#endstruct

stdim st, NOTIFYICONDATAA        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。