Win32 API 日本語リファレンス
ホーム › UI.Controls.Dialogs › DEVNAMES

DEVNAMES

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 8 バイト / x86: 8 バイトパッキング1

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

フィールド

フィールド型サイズx64x86説明
wDriverOffsetWORD2+0+0この構造体の先頭から、デバイスドライバーのファイル名 (拡張子なし) を格納する null 終端文字列までのオフセット (文字単位) です。入力時には、この文字列はダイアログボックスに最初に表示するプリンターを決定するために使用されます。
wDeviceOffsetWORD2+2+2この構造体の先頭から、デバイス名を格納する null 終端文字列までのオフセット (文字単位) です。
wOutputOffsetWORD2+4+4この構造体の先頭から、物理的な出力媒体 (出力ポート) のデバイス名を格納する null 終端文字列までのオフセット (文字単位) です。
wDefaultWORD2+6+6DEVNAMES 構造体に格納されている文字列が既定のプリンターを識別するかどうかを示します。この文字列は、前回の印刷操作以降に既定のプリンターが変更されていないことを確認するために使用されます。いずれかの文字列が一致しない場合は、ドキュメントの再フォーマットが必要になる可能性があることをユーザーに通知する警告メッセージが表示されます。出力時には、wDefault メンバーは、印刷設定 ダイアログボックスが表示され、ユーザーが OK ボタンを選択した場合にのみ変更されます。既定のプリンターが選択された場合は DN_DEFAULTPRN フラグが使用されます。特定のプリンターが選択された場合、このフラグは使用されません。このメンバーの他のすべてのフラグは、印刷 プロパティシートまたは 印刷 ダイアログボックスのダイアログボックスプロシージャが内部的に使用するために予約されています。

公式ドキュメント

プリンターのドライバー名、デバイス名、および出力ポート名を識別する文字列を格納します。これらの文字列は、PrintDlg または PrintDlgEx の ANSI 版を使用する場合は ANSI 文字列でなければならず、PrintDlg または PrintDlgEx の Unicode 版を使用する場合は Unicode 文字列でなければなりません。PrintDlgEx 関数および PrintDlg 関数は、これらの文字列を使用して、システム定義の 印刷プロパティシート または 印刷ダイアログボックス を初期化します。ユーザーがプロパティシートまたはダイアログボックスを閉じると、選択されたプリンターに関する情報がこの構造体で返されます。

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

各言語での定義

#include <windows.h>

// DEVNAMES  (x64 8 / x86 8 バイト)
#pragma pack(push, 1)
typedef struct DEVNAMES {
    WORD wDriverOffset;
    WORD wDeviceOffset;
    WORD wOutputOffset;
    WORD wDefault;
} DEVNAMES;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct DEVNAMES
{
    public ushort wDriverOffset;
    public ushort wDeviceOffset;
    public ushort wOutputOffset;
    public ushort wDefault;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure DEVNAMES
    Public wDriverOffset As UShort
    Public wDeviceOffset As UShort
    Public wOutputOffset As UShort
    Public wDefault As UShort
End Structure
import ctypes
from ctypes import wintypes

class DEVNAMES(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("wDriverOffset", ctypes.c_ushort),
        ("wDeviceOffset", ctypes.c_ushort),
        ("wOutputOffset", ctypes.c_ushort),
        ("wDefault", ctypes.c_ushort),
    ]
#[repr(C, packed(1))]
pub struct DEVNAMES {
    pub wDriverOffset: u16,
    pub wDeviceOffset: u16,
    pub wOutputOffset: u16,
    pub wDefault: u16,
}
import "golang.org/x/sys/windows"

type DEVNAMES struct {
	wDriverOffset uint16
	wDeviceOffset uint16
	wOutputOffset uint16
	wDefault uint16
}
type
  DEVNAMES = packed record
    wDriverOffset: Word;
    wDeviceOffset: Word;
    wOutputOffset: Word;
    wDefault: Word;
  end;
const DEVNAMES = extern struct {
    wDriverOffset: u16,
    wDeviceOffset: u16,
    wOutputOffset: u16,
    wDefault: u16,
};
type
  DEVNAMES {.packed.} = object
    wDriverOffset: uint16
    wDeviceOffset: uint16
    wOutputOffset: uint16
    wDefault: uint16
align(1)
struct DEVNAMES
{
    ushort wDriverOffset;
    ushort wDeviceOffset;
    ushort wOutputOffset;
    ushort wDefault;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DEVNAMES サイズ: 8 バイト(x64)
dim st, 2    ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; wDriverOffset : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; wDeviceOffset : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; wOutputOffset : WORD (+4, 2byte)  wpoke st,4,値  /  値 = wpeek(st,4)
; wDefault : WORD (+6, 2byte)  wpoke st,6,値  /  値 = wpeek(st,6)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DEVNAMES, pack=1
    #field short wDriverOffset
    #field short wDeviceOffset
    #field short wOutputOffset
    #field short wDefault
#endstruct

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