ホーム › Devices.Tapi › TUISPICREATEDIALOGINSTANCEPARAMS
TUISPICREATEDIALOGINSTANCEPARAMS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwRequestID | DWORD | 4 | +0 | +0 | 自発的な UI が関連付けられている非同期 TSPI 関数のパラメーターとして、サービス プロバイダーに渡された dwRequestID です。TAPI はこれを使用して、UI DLL を読み込み TUISPI_providerGenericDialog 関数を呼び出す対象となる、コンテキストのアプリケーションを識別します。 |
| hdDlgInst | HDRVDIALOGINSTANCE | 8/4 | +8 | +4 | 汎用ダイアログ ボックスのインスタンスとの関連付けに対する、サービス プロバイダーの識別子です。汎用ダイアログ ボックスの複数のインスタンスが、同一または複数のアプリケーションで開かれる可能性があるため、サービス プロバイダーは、そのプロバイダーのコンテキスト内に存在するインスタンスの範囲でこのハンドルが一意になるようにしなければなりません。 |
| htDlgInst | DWORD | 4 | +16 | +8 | TAPI は、作成された関連付けに対する識別子をこのメンバーに書き込みます。関連付けの作成に失敗した場合、このメンバーは NULL に設定されます。その場合、サービス プロバイダーが対象のアプリケーションのコンテキストで自発的にダイアログ ボックスを作成することはできません。サービス プロバイダーは、UI DLL へデータを送信するメッセージ (LINE_SENDDIALOGINSTANCEDATA) で、この識別子を使用しなければなりません。 |
| lpszUIDLLName | LPWSTR | 8/4 | +24 | +12 | アプリケーションのコンテキストで読み込む UI DLL の完全修飾名を指定する、NULL で終わる文字列へのポインターです。 |
| lpParams | void* | 8/4 | +32 | +16 | UI DLL の TUISPI_providerGenericDialog 関数へ渡される、プライベートなパラメーター ブロックへのポインターです。パラメーター ブロックの内容は、サービス プロバイダーと UI DLL が決定します。転送は一方向であり、UI DLL がパラメーター ブロックを変更してサービス プロバイダーに返すことはできません。通常このブロックは、どのダイアログ ボックスを表示するかを UI DLL に指示し、(必要な場合は) 表示する情報を格納します。 |
| dwSize | DWORD | 4 | +40 | +20 | パラメーター ブロックのサイズ (バイト単位) です。 |
公式ドキュメント
TAPI のダイアログ操作用のパラメーターを定義します。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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>
// TUISPICREATEDIALOGINSTANCEPARAMS (x64 48 / x86 24 バイト)
typedef struct TUISPICREATEDIALOGINSTANCEPARAMS {
DWORD dwRequestID;
HDRVDIALOGINSTANCE hdDlgInst;
DWORD htDlgInst;
LPWSTR lpszUIDLLName;
void* lpParams;
DWORD dwSize;
} TUISPICREATEDIALOGINSTANCEPARAMS;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TUISPICREATEDIALOGINSTANCEPARAMS
{
public uint dwRequestID;
public IntPtr hdDlgInst;
public uint htDlgInst;
public IntPtr lpszUIDLLName;
public IntPtr lpParams;
public uint dwSize;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TUISPICREATEDIALOGINSTANCEPARAMS
Public dwRequestID As UInteger
Public hdDlgInst As IntPtr
Public htDlgInst As UInteger
Public lpszUIDLLName As IntPtr
Public lpParams As IntPtr
Public dwSize As UInteger
End Structureimport ctypes
from ctypes import wintypes
class TUISPICREATEDIALOGINSTANCEPARAMS(ctypes.Structure):
_fields_ = [
("dwRequestID", wintypes.DWORD),
("hdDlgInst", ctypes.c_void_p),
("htDlgInst", wintypes.DWORD),
("lpszUIDLLName", ctypes.c_void_p),
("lpParams", ctypes.c_void_p),
("dwSize", wintypes.DWORD),
]#[repr(C)]
pub struct TUISPICREATEDIALOGINSTANCEPARAMS {
pub dwRequestID: u32,
pub hdDlgInst: *mut core::ffi::c_void,
pub htDlgInst: u32,
pub lpszUIDLLName: *mut core::ffi::c_void,
pub lpParams: *mut core::ffi::c_void,
pub dwSize: u32,
}import "golang.org/x/sys/windows"
type TUISPICREATEDIALOGINSTANCEPARAMS struct {
dwRequestID uint32
hdDlgInst uintptr
htDlgInst uint32
lpszUIDLLName uintptr
lpParams uintptr
dwSize uint32
}type
TUISPICREATEDIALOGINSTANCEPARAMS = record
dwRequestID: DWORD;
hdDlgInst: Pointer;
htDlgInst: DWORD;
lpszUIDLLName: Pointer;
lpParams: Pointer;
dwSize: DWORD;
end;const TUISPICREATEDIALOGINSTANCEPARAMS = extern struct {
dwRequestID: u32,
hdDlgInst: ?*anyopaque,
htDlgInst: u32,
lpszUIDLLName: ?*anyopaque,
lpParams: ?*anyopaque,
dwSize: u32,
};type
TUISPICREATEDIALOGINSTANCEPARAMS {.bycopy.} = object
dwRequestID: uint32
hdDlgInst: pointer
htDlgInst: uint32
lpszUIDLLName: pointer
lpParams: pointer
dwSize: uint32struct TUISPICREATEDIALOGINSTANCEPARAMS
{
uint dwRequestID;
void* hdDlgInst;
uint htDlgInst;
void* lpszUIDLLName;
void* lpParams;
uint dwSize;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; TUISPICREATEDIALOGINSTANCEPARAMS サイズ: 24 バイト(x86)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; dwRequestID : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hdDlgInst : HDRVDIALOGINSTANCE (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; htDlgInst : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; lpszUIDLLName : LPWSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; lpParams : void* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwSize : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; TUISPICREATEDIALOGINSTANCEPARAMS サイズ: 48 バイト(x64)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; dwRequestID : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hdDlgInst : HDRVDIALOGINSTANCE (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; htDlgInst : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; lpszUIDLLName : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpParams : void* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; dwSize : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global TUISPICREATEDIALOGINSTANCEPARAMS
#field int dwRequestID
#field intptr hdDlgInst
#field int htDlgInst
#field intptr lpszUIDLLName
#field intptr lpParams
#field int dwSize
#endstruct
stdim st, TUISPICREATEDIALOGINSTANCEPARAMS ; NSTRUCT 変数を確保
st->dwRequestID = 100
mes "dwRequestID=" + st->dwRequestID