ホーム › UI.ColorSystem › ColorProfileGetDisplayDefault
ColorProfileGetDisplayDefault
関数ディスプレイの既定カラープロファイル名を取得する。
シグネチャ
// mscms.dll
#include <windows.h>
HRESULT ColorProfileGetDisplayDefault(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
LUID targetAdapterID,
DWORD sourceID,
COLORPROFILETYPE profileType,
COLORPROFILESUBTYPE profileSubType,
LPWSTR* profileName
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| scope | WCS_PROFILE_MANAGEMENT_SCOPE | in | 対象の管理範囲(システム全体/現在ユーザー)を示すWCSスコープ列挙値。 |
| targetAdapterID | LUID | in | 対象ディスプレイのアダプタを識別するLUID値。 |
| sourceID | DWORD | in | アダプタ上の対象ソース(出力)を識別するID。 |
| profileType | COLORPROFILETYPE | in | プロファイルの種別(ICC/WCS等)を示す列挙値。 |
| profileSubType | COLORPROFILESUBTYPE | in | プロファイルのサブ種別を示す列挙値。 |
| profileName | LPWSTR* | out | 既定プロファイル名のアドレスを受け取るポインタ。解放が必要。 |
戻り値の型: HRESULT
各言語での呼び出し定義
// mscms.dll
#include <windows.h>
HRESULT ColorProfileGetDisplayDefault(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
LUID targetAdapterID,
DWORD sourceID,
COLORPROFILETYPE profileType,
COLORPROFILESUBTYPE profileSubType,
LPWSTR* profileName
);[DllImport("mscms.dll", ExactSpelling = true)]
static extern int ColorProfileGetDisplayDefault(
int scope, // WCS_PROFILE_MANAGEMENT_SCOPE
LUID targetAdapterID, // LUID
uint sourceID, // DWORD
int profileType, // COLORPROFILETYPE
int profileSubType, // COLORPROFILESUBTYPE
IntPtr profileName // LPWSTR* out
);<DllImport("mscms.dll", ExactSpelling:=True)>
Public Shared Function ColorProfileGetDisplayDefault(
scope As Integer, ' WCS_PROFILE_MANAGEMENT_SCOPE
targetAdapterID As LUID, ' LUID
sourceID As UInteger, ' DWORD
profileType As Integer, ' COLORPROFILETYPE
profileSubType As Integer, ' COLORPROFILESUBTYPE
profileName As IntPtr ' LPWSTR* out
) As Integer
End Function' scope : WCS_PROFILE_MANAGEMENT_SCOPE
' targetAdapterID : LUID
' sourceID : DWORD
' profileType : COLORPROFILETYPE
' profileSubType : COLORPROFILESUBTYPE
' profileName : LPWSTR* out
Declare PtrSafe Function ColorProfileGetDisplayDefault Lib "mscms" ( _
ByVal scope As Long, _
ByVal targetAdapterID As LongPtr, _
ByVal sourceID As Long, _
ByVal profileType As Long, _
ByVal profileSubType As Long, _
ByVal profileName As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
ColorProfileGetDisplayDefault = ctypes.windll.mscms.ColorProfileGetDisplayDefault
ColorProfileGetDisplayDefault.restype = ctypes.c_int
ColorProfileGetDisplayDefault.argtypes = [
ctypes.c_int, # scope : WCS_PROFILE_MANAGEMENT_SCOPE
LUID, # targetAdapterID : LUID
wintypes.DWORD, # sourceID : DWORD
ctypes.c_int, # profileType : COLORPROFILETYPE
ctypes.c_int, # profileSubType : COLORPROFILESUBTYPE
ctypes.c_void_p, # profileName : LPWSTR* out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('mscms.dll')
ColorProfileGetDisplayDefault = Fiddle::Function.new(
lib['ColorProfileGetDisplayDefault'],
[
Fiddle::TYPE_INT, # scope : WCS_PROFILE_MANAGEMENT_SCOPE
Fiddle::TYPE_VOIDP, # targetAdapterID : LUID
-Fiddle::TYPE_INT, # sourceID : DWORD
Fiddle::TYPE_INT, # profileType : COLORPROFILETYPE
Fiddle::TYPE_INT, # profileSubType : COLORPROFILESUBTYPE
Fiddle::TYPE_VOIDP, # profileName : LPWSTR* out
],
Fiddle::TYPE_INT)#[link(name = "mscms")]
extern "system" {
fn ColorProfileGetDisplayDefault(
scope: i32, // WCS_PROFILE_MANAGEMENT_SCOPE
targetAdapterID: LUID, // LUID
sourceID: u32, // DWORD
profileType: i32, // COLORPROFILETYPE
profileSubType: i32, // COLORPROFILESUBTYPE
profileName: *mut *mut u16 // LPWSTR* out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("mscms.dll")]
public static extern int ColorProfileGetDisplayDefault(int scope, LUID targetAdapterID, uint sourceID, int profileType, int profileSubType, IntPtr profileName);
"@
$api = Add-Type -MemberDefinition $sig -Name 'mscms_ColorProfileGetDisplayDefault' -Namespace Win32 -PassThru
# $api::ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName)#uselib "mscms.dll"
#func global ColorProfileGetDisplayDefault "ColorProfileGetDisplayDefault" sptr, sptr, sptr, sptr, sptr, sptr
; ColorProfileGetDisplayDefault scope, targetAdapterID, sourceID, profileType, profileSubType, varptr(profileName) ; 戻り値は stat
; scope : WCS_PROFILE_MANAGEMENT_SCOPE -> "sptr"
; targetAdapterID : LUID -> "sptr"
; sourceID : DWORD -> "sptr"
; profileType : COLORPROFILETYPE -> "sptr"
; profileSubType : COLORPROFILESUBTYPE -> "sptr"
; profileName : LPWSTR* out -> "sptr"
; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "mscms.dll" #cfunc global ColorProfileGetDisplayDefault "ColorProfileGetDisplayDefault" int, int, int, int, int, var ; res = ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName) ; scope : WCS_PROFILE_MANAGEMENT_SCOPE -> "int" ; targetAdapterID : LUID -> "int" ; sourceID : DWORD -> "int" ; profileType : COLORPROFILETYPE -> "int" ; profileSubType : COLORPROFILESUBTYPE -> "int" ; profileName : LPWSTR* out -> "var" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "mscms.dll" #cfunc global ColorProfileGetDisplayDefault "ColorProfileGetDisplayDefault" int, int, int, int, int, sptr ; res = ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, varptr(profileName)) ; scope : WCS_PROFILE_MANAGEMENT_SCOPE -> "int" ; targetAdapterID : LUID -> "int" ; sourceID : DWORD -> "int" ; profileType : COLORPROFILETYPE -> "int" ; profileSubType : COLORPROFILESUBTYPE -> "int" ; profileName : LPWSTR* out -> "sptr" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT ColorProfileGetDisplayDefault(WCS_PROFILE_MANAGEMENT_SCOPE scope, LUID targetAdapterID, DWORD sourceID, COLORPROFILETYPE profileType, COLORPROFILESUBTYPE profileSubType, LPWSTR* profileName) #uselib "mscms.dll" #cfunc global ColorProfileGetDisplayDefault "ColorProfileGetDisplayDefault" int, int, int, int, int, var ; res = ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName) ; scope : WCS_PROFILE_MANAGEMENT_SCOPE -> "int" ; targetAdapterID : LUID -> "int" ; sourceID : DWORD -> "int" ; profileType : COLORPROFILETYPE -> "int" ; profileSubType : COLORPROFILESUBTYPE -> "int" ; profileName : LPWSTR* out -> "var" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT ColorProfileGetDisplayDefault(WCS_PROFILE_MANAGEMENT_SCOPE scope, LUID targetAdapterID, DWORD sourceID, COLORPROFILETYPE profileType, COLORPROFILESUBTYPE profileSubType, LPWSTR* profileName) #uselib "mscms.dll" #cfunc global ColorProfileGetDisplayDefault "ColorProfileGetDisplayDefault" int, int, int, int, int, intptr ; res = ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, varptr(profileName)) ; scope : WCS_PROFILE_MANAGEMENT_SCOPE -> "int" ; targetAdapterID : LUID -> "int" ; sourceID : DWORD -> "int" ; profileType : COLORPROFILETYPE -> "int" ; profileSubType : COLORPROFILESUBTYPE -> "int" ; profileName : LPWSTR* out -> "intptr" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
mscms = windows.NewLazySystemDLL("mscms.dll")
procColorProfileGetDisplayDefault = mscms.NewProc("ColorProfileGetDisplayDefault")
)
// scope (WCS_PROFILE_MANAGEMENT_SCOPE), targetAdapterID (LUID), sourceID (DWORD), profileType (COLORPROFILETYPE), profileSubType (COLORPROFILESUBTYPE), profileName (LPWSTR* out)
r1, _, err := procColorProfileGetDisplayDefault.Call(
uintptr(scope),
uintptr(targetAdapterID),
uintptr(sourceID),
uintptr(profileType),
uintptr(profileSubType),
uintptr(profileName),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction ColorProfileGetDisplayDefault(
scope: Integer; // WCS_PROFILE_MANAGEMENT_SCOPE
targetAdapterID: LUID; // LUID
sourceID: DWORD; // DWORD
profileType: Integer; // COLORPROFILETYPE
profileSubType: Integer; // COLORPROFILESUBTYPE
profileName: PPWideChar // LPWSTR* out
): Integer; stdcall;
external 'mscms.dll' name 'ColorProfileGetDisplayDefault';result := DllCall("mscms\ColorProfileGetDisplayDefault"
, "Int", scope ; WCS_PROFILE_MANAGEMENT_SCOPE
, "Ptr", targetAdapterID ; LUID
, "UInt", sourceID ; DWORD
, "Int", profileType ; COLORPROFILETYPE
, "Int", profileSubType ; COLORPROFILESUBTYPE
, "Ptr", profileName ; LPWSTR* out
, "Int") ; return: HRESULT●ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName) = DLL("mscms.dll", "int ColorProfileGetDisplayDefault(int, void*, dword, int, int, void*)")
# 呼び出し: ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName)
# scope : WCS_PROFILE_MANAGEMENT_SCOPE -> "int"
# targetAdapterID : LUID -> "void*"
# sourceID : DWORD -> "dword"
# profileType : COLORPROFILETYPE -> "int"
# profileSubType : COLORPROFILESUBTYPE -> "int"
# profileName : LPWSTR* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "mscms" fn ColorProfileGetDisplayDefault(
scope: i32, // WCS_PROFILE_MANAGEMENT_SCOPE
targetAdapterID: LUID, // LUID
sourceID: u32, // DWORD
profileType: i32, // COLORPROFILETYPE
profileSubType: i32, // COLORPROFILESUBTYPE
profileName: [*c][*c]u16 // LPWSTR* out
) callconv(std.os.windows.WINAPI) i32;proc ColorProfileGetDisplayDefault(
scope: int32, # WCS_PROFILE_MANAGEMENT_SCOPE
targetAdapterID: LUID, # LUID
sourceID: uint32, # DWORD
profileType: int32, # COLORPROFILETYPE
profileSubType: int32, # COLORPROFILESUBTYPE
profileName: ptr WideCString # LPWSTR* out
): int32 {.importc: "ColorProfileGetDisplayDefault", stdcall, dynlib: "mscms.dll".}pragma(lib, "mscms");
extern(Windows)
int ColorProfileGetDisplayDefault(
int scope, // WCS_PROFILE_MANAGEMENT_SCOPE
LUID targetAdapterID, // LUID
uint sourceID, // DWORD
int profileType, // COLORPROFILETYPE
int profileSubType, // COLORPROFILESUBTYPE
wchar** profileName // LPWSTR* out
);ccall((:ColorProfileGetDisplayDefault, "mscms.dll"), stdcall, Int32,
(Int32, LUID, UInt32, Int32, Int32, Ptr{Ptr{UInt16}}),
scope, targetAdapterID, sourceID, profileType, profileSubType, profileName)
# scope : WCS_PROFILE_MANAGEMENT_SCOPE -> Int32
# targetAdapterID : LUID -> LUID
# sourceID : DWORD -> UInt32
# profileType : COLORPROFILETYPE -> Int32
# profileSubType : COLORPROFILESUBTYPE -> Int32
# profileName : LPWSTR* out -> Ptr{Ptr{UInt16}}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t ColorProfileGetDisplayDefault(
int32_t scope,
LUID targetAdapterID,
uint32_t sourceID,
int32_t profileType,
int32_t profileSubType,
uint16_t** profileName);
]]
local mscms = ffi.load("mscms")
-- mscms.ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName)
-- scope : WCS_PROFILE_MANAGEMENT_SCOPE
-- targetAdapterID : LUID
-- sourceID : DWORD
-- profileType : COLORPROFILETYPE
-- profileSubType : COLORPROFILESUBTYPE
-- profileName : LPWSTR* out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('mscms.dll');
const ColorProfileGetDisplayDefault = lib.func('__stdcall', 'ColorProfileGetDisplayDefault', 'int32_t', ['int32_t', 'LUID', 'uint32_t', 'int32_t', 'int32_t', 'void *']);
// ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName)
// scope : WCS_PROFILE_MANAGEMENT_SCOPE -> 'int32_t'
// targetAdapterID : LUID -> 'LUID'
// sourceID : DWORD -> 'uint32_t'
// profileType : COLORPROFILETYPE -> 'int32_t'
// profileSubType : COLORPROFILESUBTYPE -> 'int32_t'
// profileName : LPWSTR* out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("mscms.dll", {
ColorProfileGetDisplayDefault: { parameters: ["i32", "buffer", "u32", "i32", "i32", "pointer"], result: "i32" },
});
// lib.symbols.ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName)
// scope : WCS_PROFILE_MANAGEMENT_SCOPE -> "i32"
// targetAdapterID : LUID -> "buffer"
// sourceID : DWORD -> "u32"
// profileType : COLORPROFILETYPE -> "i32"
// profileSubType : COLORPROFILESUBTYPE -> "i32"
// profileName : LPWSTR* out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t ColorProfileGetDisplayDefault(
int32_t scope,
LUID targetAdapterID,
uint32_t sourceID,
int32_t profileType,
int32_t profileSubType,
uint16_t** profileName);
C, "mscms.dll");
// $ffi->ColorProfileGetDisplayDefault(scope, targetAdapterID, sourceID, profileType, profileSubType, profileName);
// scope : WCS_PROFILE_MANAGEMENT_SCOPE
// targetAdapterID : LUID
// sourceID : DWORD
// profileType : COLORPROFILETYPE
// profileSubType : COLORPROFILESUBTYPE
// profileName : LPWSTR* out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Mscms extends StdCallLibrary {
Mscms INSTANCE = Native.load("mscms", Mscms.class);
int ColorProfileGetDisplayDefault(
int scope, // WCS_PROFILE_MANAGEMENT_SCOPE
LUID /* extends Structure (by value) */ targetAdapterID, // LUID
int sourceID, // DWORD
int profileType, // COLORPROFILETYPE
int profileSubType, // COLORPROFILESUBTYPE
PointerByReference profileName // LPWSTR* out
);
}@[Link("mscms")]
lib Libmscms
fun ColorProfileGetDisplayDefault = ColorProfileGetDisplayDefault(
scope : Int32, # WCS_PROFILE_MANAGEMENT_SCOPE
targetAdapterID : LUID, # LUID
sourceID : UInt32, # DWORD
profileType : Int32, # COLORPROFILETYPE
profileSubType : Int32, # COLORPROFILESUBTYPE
profileName : UInt16** # LPWSTR* out
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef ColorProfileGetDisplayDefaultNative = Int32 Function(Int32, LUID, Uint32, Int32, Int32, Pointer<Pointer<Utf16>>);
typedef ColorProfileGetDisplayDefaultDart = int Function(int, int, int, int, int, Pointer<Pointer<Utf16>>);
final ColorProfileGetDisplayDefault = DynamicLibrary.open('mscms.dll')
.lookupFunction<ColorProfileGetDisplayDefaultNative, ColorProfileGetDisplayDefaultDart>('ColorProfileGetDisplayDefault');
// scope : WCS_PROFILE_MANAGEMENT_SCOPE -> Int32
// targetAdapterID : LUID -> LUID
// sourceID : DWORD -> Uint32
// profileType : COLORPROFILETYPE -> Int32
// profileSubType : COLORPROFILESUBTYPE -> Int32
// profileName : LPWSTR* out -> Pointer<Pointer<Utf16>>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function ColorProfileGetDisplayDefault(
scope: Integer; // WCS_PROFILE_MANAGEMENT_SCOPE
targetAdapterID: LUID; // LUID
sourceID: DWORD; // DWORD
profileType: Integer; // COLORPROFILETYPE
profileSubType: Integer; // COLORPROFILESUBTYPE
profileName: PPWideChar // LPWSTR* out
): Integer; stdcall;
external 'mscms.dll' name 'ColorProfileGetDisplayDefault';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "ColorProfileGetDisplayDefault"
c_ColorProfileGetDisplayDefault :: Int32 -> LUID -> Word32 -> Int32 -> Int32 -> Ptr CWString -> IO Int32
-- scope : WCS_PROFILE_MANAGEMENT_SCOPE -> Int32
-- targetAdapterID : LUID -> LUID
-- sourceID : DWORD -> Word32
-- profileType : COLORPROFILETYPE -> Int32
-- profileSubType : COLORPROFILESUBTYPE -> Int32
-- profileName : LPWSTR* out -> Ptr CWString
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
-- ※値渡し構造体は GHC FFI で直接渡せません。Ptr で渡すラッパ(C側)経由にしてください。open Ctypes
open Foreign
let colorprofilegetdisplaydefault =
foreign "ColorProfileGetDisplayDefault"
(int32_t @-> LUID @-> uint32_t @-> int32_t @-> int32_t @-> (ptr (ptr uint16_t)) @-> returning int32_t)
(* scope : WCS_PROFILE_MANAGEMENT_SCOPE -> int32_t *)
(* targetAdapterID : LUID -> LUID *)
(* sourceID : DWORD -> uint32_t *)
(* profileType : COLORPROFILETYPE -> int32_t *)
(* profileSubType : COLORPROFILESUBTYPE -> int32_t *)
(* profileName : LPWSTR* out -> (ptr (ptr uint16_t)) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library mscms (t "mscms.dll"))
(cffi:use-foreign-library mscms)
(cffi:defcfun ("ColorProfileGetDisplayDefault" color-profile-get-display-default :convention :stdcall) :int32
(scope :int32) ; WCS_PROFILE_MANAGEMENT_SCOPE
(target-adapter-id (:struct luid)) ; LUID
(source-id :uint32) ; DWORD
(profile-type :int32) ; COLORPROFILETYPE
(profile-sub-type :int32) ; COLORPROFILESUBTYPE
(profile-name :pointer)) ; LPWSTR* out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $ColorProfileGetDisplayDefault = Win32::API::More->new('mscms',
'int ColorProfileGetDisplayDefault(int scope, LPVOID targetAdapterID, DWORD sourceID, int profileType, int profileSubType, LPVOID profileName)');
# my $ret = $ColorProfileGetDisplayDefault->Call($scope, $targetAdapterID, $sourceID, $profileType, $profileSubType, $profileName);
# scope : WCS_PROFILE_MANAGEMENT_SCOPE -> int
# targetAdapterID : LUID -> LPVOID
# sourceID : DWORD -> DWORD
# profileType : COLORPROFILETYPE -> int
# profileSubType : COLORPROFILESUBTYPE -> int
# profileName : LPWSTR* out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。