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

DFMICS

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

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。
fMaskDWORD4+4+4

0、または pici が指す CMINVOKECOMMANDINFO 構造体あるいは CMINVOKECOMMANDINFOEX 構造体内のデータの扱い方を指定する、次のフラグの 1 つ以上。

CMIC_MASK_HOTKEY

dwHotKey メンバーが有効です。

CMIC_MASK_ICON

使用されません。

CMIC_MASK_FLAG_NO_UI

IContextMenu::InvokeCommand の実装は、コマンドの実行中にユーザーインターフェイス要素 (エラーメッセージなど) を表示できなくなります。

CMIC_MASK_UNICODE

piciCMINVOKECOMMANDINFOEX 構造体を指す場合にのみ使用されます。ショートカットメニューハンドラーが ANSI 版のメンバーではなく lpVerbWlpParametersWlpTitleWlpDirectoryW の各メンバーを使用することを示します。一部のショートカットメニューハンドラーは Unicode をサポートしていない可能性があるため、lpVerblpParameterslpTitleWlpDirectory の各メンバーにも有効な ANSI 文字列を渡してください。

CMIC_MASK_NO_CONSOLE

ショートカットメニューハンドラーが新しいプロセスを作成する必要がある場合、通常は新しいコンソールを作成します。CMIC_MASK_NO_CONSOLE フラグを設定すると、新しいコンソールの作成が抑止されます。

CMIC_MASK_FLAG_SEP_VDM

このフラグは、16 ビットの Windows ベースアプリケーションを参照する場合にのみ有効です。設定した場合、ショートカットが指すアプリケーションはプライベートな仮想 DOS マシン (VDM) 内で実行されます。「解説」を参照してください。

CMIC_MASK_ASYNCOK

IContextMenu::InvokeCommand の実装は、呼び出しを処理するために新しいスレッドまたはプロセスを起動することができ、呼び出された関数の完了を待ってブロックする必要はありません。たとえば動詞が "delete" の場合、IContextMenu::InvokeCommand の呼び出しは、すべての項目が削除される前に戻ることがあります。これは助言的なものであるため、このフラグを指定する呼び出し側アプリケーションは、呼び出す動詞の実装を把握していない限り、この要求が尊重される保証はありません。

CMIC_MASK_NOASYNC

Windows Vista 以降。 IContextMenu::InvokeCommand の実装は同期的であり、処理が完了する前に戻らないようにする必要があります。これは推奨事項であるため、このフラグを指定する呼び出し側アプリケーションは、呼び出す動詞の実装を把握していない限り、この要求が尊重される保証はありません。

CMIC_MASK_SHIFT_DOWN

SHIFT キーが押されています。動詞が呼び出された後に変化している可能性のあるキーボードの現在の状態をポーリングする代わりに、これを使用してください。

CMIC_MASK_CONTROL_DOWN

CTRL キーが押されています。動詞が呼び出された後に変化している可能性のあるキーボードの現在の状態をポーリングする代わりに、これを使用してください。

CMIC_MASK_FLAG_LOG_USAGE

IContextMenu::InvokeCommand の実装が、「最近使ったドキュメント」メニューなどの機能のために、呼び出された項目を記録しておく場合があることを示します。

CMIC_MASK_NOZONECHECKS

ゾーンチェックを実行しません。このフラグにより、ShellExecuteExIAttachmentExecute によって設定されたゾーンチェックをバイパスできます。

CMIC_MASK_PTINVOKE

piciCMINVOKECOMMANDINFOEX 構造体を指す場合にのみ使用されます。ptInvoke メンバーが有効です。

lParamLPARAM8/4+8+8選択されたメニューコマンドに対する追加の引数を格納する、null で終わる文字列へのポインター。このメンバーは NULL でもかまいません。
idCmdFirstDWORD4+16+12ハンドラーがメニュー項目の識別子として指定できる最小値。
idDefMaxDWORD4+20+16ハンドラーがメニュー項目の識別子として指定できる最大値。
piciCMINVOKECOMMANDINFO*8/4+24+20CMINVOKECOMMANDINFO 構造体または CMINVOKECOMMANDINFO 構造体へのポインター。
punkSiteIUnknown*8/4+32+24コンテキストメニューハンドラーのサイトへのポインター。

公式ドキュメント

DFM_INVOKECOMMANDEX で使用される追加の引数を格納します。

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

各言語での定義

#include <windows.h>

// DFMICS  (x64 40 / x86 28 バイト)
typedef struct DFMICS {
    DWORD cbSize;
    DWORD fMask;
    LPARAM lParam;
    DWORD idCmdFirst;
    DWORD idDefMax;
    CMINVOKECOMMANDINFO* pici;
    IUnknown* punkSite;
} DFMICS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DFMICS
{
    public uint cbSize;
    public uint fMask;
    public IntPtr lParam;
    public uint idCmdFirst;
    public uint idDefMax;
    public IntPtr pici;
    public IntPtr punkSite;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DFMICS
    Public cbSize As UInteger
    Public fMask As UInteger
    Public lParam As IntPtr
    Public idCmdFirst As UInteger
    Public idDefMax As UInteger
    Public pici As IntPtr
    Public punkSite As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DFMICS(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("fMask", wintypes.DWORD),
        ("lParam", ctypes.c_ssize_t),
        ("idCmdFirst", wintypes.DWORD),
        ("idDefMax", wintypes.DWORD),
        ("pici", ctypes.c_void_p),
        ("punkSite", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DFMICS {
    pub cbSize: u32,
    pub fMask: u32,
    pub lParam: isize,
    pub idCmdFirst: u32,
    pub idDefMax: u32,
    pub pici: *mut core::ffi::c_void,
    pub punkSite: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DFMICS struct {
	cbSize uint32
	fMask uint32
	lParam uintptr
	idCmdFirst uint32
	idDefMax uint32
	pici uintptr
	punkSite uintptr
}
type
  DFMICS = record
    cbSize: DWORD;
    fMask: DWORD;
    lParam: NativeInt;
    idCmdFirst: DWORD;
    idDefMax: DWORD;
    pici: Pointer;
    punkSite: Pointer;
  end;
const DFMICS = extern struct {
    cbSize: u32,
    fMask: u32,
    lParam: isize,
    idCmdFirst: u32,
    idDefMax: u32,
    pici: ?*anyopaque,
    punkSite: ?*anyopaque,
};
type
  DFMICS {.bycopy.} = object
    cbSize: uint32
    fMask: uint32
    lParam: int
    idCmdFirst: uint32
    idDefMax: uint32
    pici: pointer
    punkSite: pointer
struct DFMICS
{
    uint cbSize;
    uint fMask;
    ptrdiff_t lParam;
    uint idCmdFirst;
    uint idDefMax;
    void* pici;
    void* punkSite;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DFMICS サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fMask : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lParam : LPARAM (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; idCmdFirst : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; idDefMax : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pici : CMINVOKECOMMANDINFO* (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; punkSite : IUnknown* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DFMICS サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fMask : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lParam : LPARAM (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; idCmdFirst : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; idDefMax : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pici : CMINVOKECOMMANDINFO* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; punkSite : IUnknown* (+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 どちらでも同じコードで動作します。
#defstruct global DFMICS
    #field int cbSize
    #field int fMask
    #field intptr lParam
    #field int idCmdFirst
    #field int idDefMax
    #field intptr pici
    #field intptr punkSite
#endstruct

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